/api/v1/profile/enrich-bulk

10 credits

Submit a bulk people-enrichment job (up to 1000 profiles). POST a JSON body; returns a job_id to poll via /api/v1/profile/enrich-bulk-status. Billed at 10 credits per item submitted.

Try in Playground

Parameters

Name	Type	Required	Description
items	string	yes	JSON body field: an array (1-1000) of person ids (prsn_...) and/or public handles to enrich. (e.g. `["prsn_pgvv42ri57uei", "satyanadella"]`)
enrich_live	boolean	no	JSON body field: force the freshest per-item live resolution instead of the standard dataset read (slower, costs like a live lookup).

Example request

curl -H "X-API-Key: zq_…" \
  "https://zooq.dev/api/v1/profile/enrich-bulk?items=%5B%22prsn_pgvv42ri57uei%22%2C+%22satyanadella%22%5D"

Example response

// POST body: { "items": ["prsn_pgvv42ri57uei", "satyanadella"] }
{
  "success": true,
  "statusCode": 202,
  "message": "Job accepted",
  "errors": null,
  "data": { "job_id": "job_3xk9p2" }
}

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 →