GET
/api/v1/search/companies-live
10 credits
LIVE company search. Its draw is `hasJobs` — an actively-hiring filter available nowhere else in the catalog — plus bucketed headcount search. For firmographic filtering (staff/follower counts, founded year, website) use /api/v1/search/companies instead. Offset-paginated. Not-found is free upstream.
Try in PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| keyword | string | yes | Search keyword. Required by the upstream for this endpoint. (e.g. fintech) |
| headcountRange | string | no | Employee-count bucket. Accepted values: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+. |
| hasJobs | string | no | Only companies with open postings — a hiring-intent signal. Accepted values: true, false. |
| industry | string | no | Industry id(s), comma-separated. Takes an upstream id, NOT free text. No Zooq or upstream endpoint currently mints these ids, so free text is ignored (you get unfiltered results) — leave it unset until that changes. See ROADMAP F. |
| geoEntityId | string | no | HQ location filter. Geo entity id — this is LinkedIn's own public geo id, and it works. To find one: type your target city, state or country into the location box on LinkedIn search, pick the right match from the auto-complete dropdown, press enter to load the results page, then read `geoId=` followed by a long number out of the browser address bar (e.g. Israel = 101620260). Comma-separate for several. Resolve once and reuse it. Verified working on this endpoint. If you would rather filter by plain text, /api/v1/search/companies takes hq_city / hq_country_code instead. (e.g. 101620260) |
| count | integer | no | Results per page, 0-50 (default 25). |
| start | integer | no | Pagination offset, 0-999. |
Example request
curl -H "X-API-Key: zq_…" \ "https://zooq.dev/api/v1/search/companies-live?keyword=fintech&geoEntityId=101620260"
Example response
A worked example for this endpoint is on its way. In the meantime, try it in the Playground with your API key to see the live shape.
Available via MCP as search_companies_live
Add Zooq as an MCP server to Claude Desktop or Cursor and call this tool directly from your agent. See the MCP guide.
Want to try this endpoint?
300 free credits on signup, no card required. That covers 30 calls.
Get an API key →