POST/v3/live/person/asynchronous/enrich

Bulk enrich

Accepts a list of person enrichment requests and returns a batch ID. Accepts up to 500 requests; processing is asynchronous, so poll GET /person/asynchronous/enrich/{id} for status and results.

Version
v3Open on v2
Rate limit
Tier 3 · 10–200 rps by plan
Billing
Person Enrichment · Bulk enrich

Request body

  • freshnessenum PersonEnrichmentFreshnessOptional
    Controls whether to use cached data regardless of age. FRESH (default) re-scrapes stale profiles; CACHED returns stored data without a freshness check.
  • metadataobjectOptional
    Optional metadata to associate with the request. Will be returned in the response.
  • personIdstringOptional
    The AggKnowledge person ID.
  • socialProfilestringOptional
    Social profile URL of the person. Protocol and subdomain are optional; we normalize the URL server-side. Sales Navigator lead URLs and Recruiter /talent/profile/ URLs are also accepted.
Headers
x-api-key Required · API key for authentication

Response

  • batchIdstring
    The batch ID of the bulk enrichment request. Use this to check the status of the request and fetch the data.

Status codes