GET
/api/v1/search/companies
10 credits
Search organizations by name or website with firmographic filters. Cursor-paginated.
Try in PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| name | string | no | Company name (min 3 chars). Provide name OR website. (e.g. microsoft) |
| website | string | no | Company website (min 3 chars). Provide name OR website. (e.g. microsoft.com) |
| 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. |
| industries | string | no | Industry name(s) — pass plain strings, comma-separated. (e.g. Software Development) |
| industries_v2 | string | no | Industry v2 taxonomy name(s), comma-separated. |
| hq_city | string | no | HQ city filter. |
| hq_country_code | string | no | HQ ISO country code. (e.g. us) |
| founded | integer | no | Founded year. |
| limit | integer | no | Results per page, 1-50 (default 20). |
| cursor | string | no | Opaque pagination cursor; omit for the first page. |
Example request
curl -H "X-API-Key: zq_…" \ "https://zooq.dev/api/v1/search/companies?name=microsoft&website=microsoft.com&industries=Software+Development&hq_country_code=us"
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"], "industries_v2": ["Software Development"], "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" }
],
"pagination": { "limit": 2, "has_more": true, "next_cursor": "cur_r1c5ol023blb0" }
}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 →