search_companies
Searches the company database by name or domain keyword, industry, HQ country, headcount, revenue and technologies.
Search companies · Read-only
Searches the company database by name or domain keyword, industry, HQ country, headcount, revenue and technologies. Use it to build company target lists. For people at those companies use search_people. For the companies visiting your own website use get_leads. Searching uses no credits, but each search that returns results counts against the plan's search limit, and the call returns 400 ('You have reached your limit.' or 'You have no credit.') when the account is out. It can return 503 provider_unavailable; retry after a minute. Returns { total, companies[], note }. Rows have employees (real headcount), employeesRange, country, countryCode (ISO alpha-2), revenueRange (bounds null when unknown), industries and industry (the one your filter matched). When you set employeesMin or employeesMax, every row is inside the range, and total may be an estimate (totalIsEstimate).
| Connection | Account URL, team member URL or OAuth |
|---|
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
websiteId | string | Yes | Website ID from list_websites. The search runs under this website. |
query | object | Yes | Search filters as one flat object. Every field is optional; combine them to narrow the search. |
query.keywords | string | No | Company name or domain keyword, e.g. "acme" or "acme.example". |
query.industries | string[] | No | Industry names, e.g. ["Marketing and Advertising", "Computer Software"]. |
query.locations | string[] | No | Company HQ countries by full name, e.g. ["United States", "Germany"]. Continents ("Europe", "Asia") are also accepted. |
query.employeesMin | number | No | Minimum headcount (whole number). Applied to the real employee count. |
query.employeesMax | number | No | Maximum headcount (whole number). Applied to the real employee count. |
query.revenueMin | number | No | Minimum annual revenue (number). Defaults to 0. |
query.revenueMax | number | No | Maximum annual revenue (number). |
query.technologies | string[] | No | Technologies the company uses, e.g. ["HubSpot", "Shopify"]. |
query.page | number | No | Page number, starting at 1. Default 1. |
query.count | number | No | Results per page. Default 25. |
Tool definition
What your assistant receives from tools/list:
{
"name": "search_companies",
"title": "Search companies",
"annotations": {
"title": "Search companies",
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": false
},
"inputSchema": {
"type": "object",
"properties": {
"websiteId": {
"type": "string",
"description": "Website ID from list_websites. The search runs under this website."
},
"query": {
"type": "object",
"description": "Search filters as one flat object. Every field is optional; combine them to narrow the search.",
"properties": {
"keywords": {
"type": "string",
"description": "Company name or domain keyword, e.g. \"acme\" or \"acme.example\"."
},
"industries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Industry names, e.g. [\"Marketing and Advertising\", \"Computer Software\"]."
},
"locations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Company HQ countries by full name, e.g. [\"United States\", \"Germany\"]. Continents (\"Europe\", \"Asia\") are also accepted."
},
"employeesMin": {
"type": "number",
"description": "Minimum headcount (whole number). Applied to the real employee count."
},
"employeesMax": {
"type": "number",
"description": "Maximum headcount (whole number). Applied to the real employee count."
},
"revenueMin": {
"type": "number",
"description": "Minimum annual revenue (number). Defaults to 0."
},
"revenueMax": {
"type": "number",
"description": "Maximum annual revenue (number)."
},
"technologies": {
"type": "array",
"items": {
"type": "string"
},
"description": "Technologies the company uses, e.g. [\"HubSpot\", \"Shopify\"]."
},
"page": {
"type": "number",
"description": "Page number, starting at 1. Default 1."
},
"count": {
"type": "number",
"description": "Results per page. Default 25."
}
}
}
},
"required": [
"websiteId",
"query"
]
}
}