POST/v2/live/person/enrich/bulk

Bulk enrich

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

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

Request body

  • metadataobjectOptional
    Optional metadata to associate with the request. Will be returned in the response.
  • pdlIdstringOptional
    The person's PDL ID.
  • personIdinteger (int64)Optional
    The AggKnowledge person ID.
  • professionalSocialMediaUrlstringOptional
    LinkedIn URL of the person. Protocol and subdomain are optional, this value will be normalized server-side. Sales Nav and Recruiter URLs are allowed.
  • 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.
  • linkedinUrlstringOptional
    Legacy name for professionalSocialMediaUrl. Send one profile identifier per request
  • linkedinUsernamestringOptional
    Profile username, an alternative to professionalSocialMediaUrl. Send one profile identifier per request: which one wins when several are sent differs by endpoint
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