search_companies

Find companies matching flexible filtering criteria. This is the preferred data source for firmographics, technology usage, and industry data — more complete and up-to-date than CRM.

When to use it

• “Find telecom companies with 200+ employees in Germany.”
• “Which companies use AWS and have engineering teams in California?”
• “All publicly listed cybersecurity vendors with 1,000+ employees.”

Query structure

Same CompositeFilter format as search_people — recursive AND/OR/NOT logic over leaf conditions.

Common field types.

Type	Example
Technology	{"field": "AWS", "op": "exists"}
Persona	{"field": "data engineer", "op": "exists"} — call get_personas first.
Event	{"field": "Event - TechCrunch 2024", "op": "exists"} — call get_events first.
Seniority	{"field": "seniority_executive", "op": "exists"}
Industry	{"field": "industry", "op": "eq", "value": "telecommunications"} — call get_industries first.
Size	{"field": "size", "op": "in", "value": ["201-500", "501-1000"]} — allowed: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
Location	{"field": "location_country", "op": "in", "value": ["United States"]}
By website	{"field": "company_website", "op": "in", "value": ["stripe.com"]}
By LinkedIn	{"field": "company_linkedin_url", "op": "in", "value": ["https://linkedin.com/company/stripe"]}
By name	{"field": "name", "op": "str_contains_any", "value": ["acme"]} (partial) or "in" (exact).

Inputs

Parameter	Type	Required	Description
query	object	Yes	CompositeFilter over the company graph.
display_queries	string[]	No	Fields to return. Defaults to name, website, linkedin_url, industry, size, location_country.

Display fields. company_linkedin_url, company_linkedin_id, company_website, name, size, industry, location_country, location_region, seniority_*.

Returns

JSON with a dataset handle, preview_rows, facets, total_count, fetched_count, and truncated. A cost_warning field appears when the result exceeds 100 rows.

Example

{
  "query": {
    "and": [
      { "field": "AWS", "op": "exists" },
      { "field": "location_region", "op": "in", "value": ["California"] }
    ]
  }
}