Search companies
companiesRead-only
Search and filter company records by keyword, exact domain, HQ country, industry group, NAICS code, employee-count bucket, or founded-year range. Costs one credit per returned record.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "companies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum records to return (1-100). Each returned record costs one credit. | |
| since | No | Return companies created/updated on or after this date (YYYY-MM-DD) or ISO-8601 timestamp. | |
| cursor | No | Opaque pagination cursor returned as pagination.nextCursor on the previous page. | |
| domain | No | Exact company domain. | |
| search | No | Keyword search over name, domain, and description. | |
| countries | No | Headquarters country codes (ISO alpha-2, OR). Pass "unknown" to include companies with no country on file. | |
| naicsCode | No | NAICS 2022 code. Matches the code and everything beneath it, so "51" also returns 5132 and 5173. Sector ranges work: "31-33" returns all manufacturing. Pass "unknown" for unclassified companies. Any 2- to 6-digit code is accepted; codes deeper than we classify (e.g. 541511) match at their deepest classified parent (5415). | |
| includeTotal | No | Also return pagination.total, the number of records matching these filters across all pages. Costs no credits. | |
| foundedYearMax | No | Maximum founded year. | |
| foundedYearMin | No | Minimum founded year. | |
| industryGroups | No | Company industry groups (OR). LinkedIn industry labels, matched case-insensitively; older LinkedIn names and short forms like "software" map to the current label. Pass "unknown" for companies with no industry on file. | |
| employeeCountBuckets | No | LinkedIn employee count buckets (OR), e.g. 51-200. Pass "unknown" for no headcount. |