Search Companies
search_companyRead-onlyIdempotent
Search companies using structured filters.
Instructions
Search companies using structured filters.
Use this for any company search: translate the user's intent (e.g. "AI startups in France that raised Series A") into structured filters on specific columns (industry, country, employee count range, funding stage, founded year, etc.). The available columns and operators are documented on the filters parameter.
Returns paginated companies matching ALL/ANY filter conditions depending on the op of the FilterGroup.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of companies to return (max 100; use offset to paginate further). | |
| offset | No | Pagination offset (number of results to skip). | |
| filters | Yes | Filter group: {"op": "and"|"or", "conditions": [<condition or nested group>, …]}; groups can be nested. Columns — basic info: name, tagline, description, domain, universal_name, keyword (full-text across name/tagline/description), industry · size & locations: employee_count, country_iso_code, city, region, office_country, office_city, office_region · growth: employee_growth_1m, employee_growth_6m, employee_growth_12m, recent_hires_count · metadata: founded_year, company_type, follower_count, page_verified, category · funding & investors: last_funding_amount_usd, last_funding_date, funding_stage_normalized, has_funding, investor · live job postings (hiring signal): job_title, job_location. Operators: =, !=, >, >=, <, <=, in, not_in, like, not_like, regex, between, is_null, is_not_null — semantics and per-column value formats are documented on the condition fields of the schema. Example — mid-size fintech/payments companies in the US or France: {"op":"and","conditions":[{"op":"or","conditions":[{"column":"category","type":"=","value":"fintech"},{"column":"description","type":"=","value":"payment processing"}]},{"column":"country_iso_code","type":"in","value":["US","FR"]},{"column":"employee_count","type":"between","value":50,"value2":500}]} | |
| order_by | No | Column to sort by, e.g. "follower_count", "employee_count", "founded_year", "last_funding_amount_usd". | |
| enrich_live | No | When true (1.5 credits/company), each company is enriched live from LinkedIn so data is fresh. When false (0.75 credits/company), data is served from the cached database — faster and cheaper. | |
| order_direction | No | Sort direction. | desc |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of companies returned in this page. | |
| error | No | HTTP-style status code, present only when the call failed. | |
| total | No | Total number of matching companies (estimate). | |
| detail | No | Error message, present only when the call failed. | |
| offset | No | Pagination offset of this page. | |
| results | No | Matching company objects. | |
| credits_used | No | Credits consumed by this search. | |
| has_next_page | No | Whether more results are available. |