GET
/api/v1/companies/name-lookup
10 credits
Search companies by name, with the full firmographic filter set. Cursor-paginated. Same upstream as /api/v1/search/companies — use whichever entry point reads better; they are equivalent.
Try in PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | yes | Company name (min 3 chars). (e.g. microsoft) |
| website | string | no | Company website domain filter. |
| industries | string | no | Industry name(s), comma-separated. Plain strings — this is the Data API, no id resolution needed. |
| industries_v2 | string | no | Industry name(s) on the newer taxonomy, comma-separated. |
| staff_count_min | integer | no | Minimum employee count. |
| staff_count_max | integer | no | Maximum employee count. |
| follower_count_min | integer | no | Minimum follower count. |
| follower_count_max | integer | no | Maximum follower count. |
| hq_city | string | no | HQ city filter (min 3 chars). |
| hq_country_code | string | no | HQ ISO country code, e.g. us. |
| founded | integer | no | Founding year filter. |
| limit | integer | no | Results per page, 1-50 (default 20). |
| cursor | string | no | Opaque pagination cursor; omit for the first page, then pass pagination.next_cursor from the previous response. |
Example request
curl -H "X-API-Key: zq_…" \ "https://zooq.dev/api/v1/companies/name-lookup?name=microsoft"
Example response
{
"success": true,
"statusCode": 200,
"message": "Data retrieved successfully",
"errors": null,
"data": [
{ "id": "org_jb3e59e3q21b8", "name": "Microsoft", "slug": "microsoft", "url": "https://www.linkedin.com/company/microsoft/", "industries": ["Computer Software"], "headcount": 233255, "headcount_range": "10,001+ employees", "follower_count": 28718941, "hq_city": "Redmond", "hq_country_code": "US" },
{ "id": "org_b018t60vhbkjc", "name": "Sirrus | Microsoft Cloud Experts", "slug": "sirrus-microsoft-cloud-experts", "url": "https://www.linkedin.com/company/sirrus-microsoft-cloud-experts/", "industries": ["Information Technology & Services"], "headcount": 31, "headcount_range": "11-50 employees", "follower_count": 1909, "founded": 2018, "hq_city": "Capelle aan den IJssel", "hq_country_code": "NL" }
]
}Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.
Want to try this endpoint?
300 free credits on signup, no card required. That covers 30 calls.
Get an API key →