GET
/api/v1/profile/enrich
10 credits
Freshest LIVE snapshot of one profile, by handle or entityId — not the deduplicated dataset record the other profile/* endpoints return. Carries live-only flags (openToWork, isHiring, isTopVoice) and returns the person's entityId, the id every other live person endpoint needs.
Try in PlaygroundParameters
| Name | Type | Required | Description |
|---|---|---|---|
| handle | string | no | Public profile handle. Provide handle OR entityId (entityId wins if both). (e.g. satyanadella) |
| entityId | string | no | Person entityId from a previous /api/v1/profile/enrich or /api/v1/profile/entity-id call. Provide handle OR entityId. |
Example request
curl -H "X-API-Key: zq_…" \ "https://zooq.dev/api/v1/profile/enrich?handle=satyanadella"
Example response
{
"success": true,
"statusCode": 200,
"message": "Data retrieved successfully",
"errors": null,
"data": {
"entityId": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVMAqfa8",
"handle": "satyanadella",
"firstName": "Satya",
"lastName": "Nadella",
"fullName": "Satya Nadella",
"headline": "Chairman and CEO at Microsoft",
"followerCount": 12086488,
"connectionsCount": 831,
"isTopVoice": true,
"premium": true,
"influencer": true,
"openToWork": false,
"isHiring": false,
"industry": "Software Development",
"location": { "city": "Redmond", "country": "United States", "countryCode": "us" }
}
}Successful responses are wrapped in the standard envelope. The data field carries the actual payload; errors is null on success.
Available via MCP as profile_enrich
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 →