Search
GET

/api/v1/search/people

10 credits

Search people with rich filters — name, title, current/past company, location, industry, school, and more.

Try in Playground

Parameters

NameTypeRequiredDescription
keywordstringnoFree-text keyword.
firstNamestringnoFilter by first name.
lastNamestringnoFilter by last name.
titlestringnoFilter by job title. (e.g. founder)
currentCompanystringnoCurrent employer — company ID(s), comma-separated. Resolve a name to an ID via /companies/universal-name-to-id. (e.g. 1035)
pastCompanystringnoPast employer — company ID(s), comma-separated. (e.g. 1035,1441)
geoUrnstringnoLocation — geo ID(s), comma-separated. Resolve a place name via /geos/name-lookup. (e.g. 103644278,90009633)
industrystringnoIndustry ID(s), comma-separated. Resolve via /g/industry-lookup. (e.g. 4,7)
schoolstringnoSchool ID(s), comma-separated. Resolve via /search/schools. (e.g. 1792,739903)
serviceCategorystringnoService category ID the profile lists as a service offered.
profileLanguagestringnoProfile language code — en for English, ch for Chinese, etc.
countintegernoResults per page, 1-50.
startintegernoPagination offset. Increment by count for the next page (count=50 → start=50, 100, ...).

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/search/people?title=founder&currentCompany=1035&pastCompany=1035%2C1441&geoUrn=103644278%2C90009633&industry=4%2C7&school=1792%2C739903"

Example response

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "people": [
      {
        "urn": "ACoAACX7L3YBrgGBVANcdx7xqQHDc441w_BM0e0",
        "profileID": "637218678",
        "url": "https://www.linkedin.com/in/sebastian-kerssen",
        "firstName": "Sebastian",
        "lastName": "Kerssen",
        "fullName": "Sebastian Kerssen",
        "headline": "Security Cloud Solution Architect @Microsoft | Founder @rebyteit",
        "location": "Munster",
        "profilePictureURL": "https://media.licdn.com/dms/image/...",
        "premium": true
      }
    ]
  },
  "errors": null
}

Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.

Available via MCP as search_people

Add Zooq as an MCP server to Claude Desktop or Cursor and call this tool directly from your agent. See the MCP guide.