GET
/api/v1/search/people-live
10 credits
LIVE people search — the only endpoint that filters by current company, past company AND school together. Complements /api/v1/search/people (the deduplicated dataset, cursor-paginated, plain-string geo): use this one for company-history sourcing, that one for broad firmographic filtering. Offset-paginated. Not-found is free upstream.
Try in PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| keyword | string | no | Free-text keyword across the profile. |
| firstName | string | no | First-name filter. |
| lastName | string | no | Last-name filter. |
| title | string | no | Job-title free-text filter. |
| currentCompany | string | no | Numeric organization id(s), comma-separated — people who work there NOW. Mint the id with /api/v1/companies/entity-id (slug -> id), then reuse it. (e.g. 1035) |
| pastCompany | string | no | Numeric organization id(s), comma-separated — alumni sourcing: people who USED to work there. Same id source as currentCompany. This filter has no equivalent on /api/v1/search/people. (e.g. 1035) |
| school | string | no | Institution id(s), comma-separated. NOTE: this is the LIVE id namespace; the inst_ ids from /api/v1/g/institution-lookup are the dataset namespace and are not known to be interchangeable — unverified, treat with care. |
| 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 | 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/people takes geo_city / geo_country_code instead. (e.g. 101620260) |
| profileLanguage | string | no | Profile primary language code, e.g. en. |
| serviceCategory | string | no | Service-category filter (for profiles offering services). |
| count | integer | no | Results per page, 0-50 (default 20). |
| start | integer | no | Pagination offset, 0-999. |
Example request
curl -H "X-API-Key: zq_…" \ "https://zooq.dev/api/v1/search/people-live?currentCompany=1035&pastCompany=1035&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_people_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 →