Start creator enrichment
POST/v1/creators/enrich
Start LinkedIn profile enrichment for a creator selection. Requires a user-scoped key.
Selection (provide exactly one): creator_ids (array of UUIDs), result_set_id (string), or result_set_ids (array). creator_ids takes precedence. This endpoint does NOT accept creators: [{ profile_url }].
Synchronous completion: if every requested creator is already enriched, the response is 200 with jobs_created: 0 and all_complete: true — no job IDs are returned. Otherwise the response is 202. Enrichment results are retrieved via POST /v1/enrichments/results using creator_ids (there is no per-job polling for enrichment). Costs 1 credit per profile enriched.
Request
Responses
- 200
- 202
- 400
- 401
- 402
- 403
- 404
- 429
- 500
- 501
All requested creators were already enriched — no jobs created. Fetch results via POST /v1/enrichments/results with creator_ids.
Enrichment queued. Poll results with POST /v1/enrichments/results using the same creator_ids.
Bad request or validation error (BAD_REQUEST / VALIDATION_ERROR).
Missing, invalid, or revoked API key.
Insufficient credits for this operation.
API access disabled or workspace entitlement required.
Resource not found, or result expired past retention.
Rate limit exceeded — back off per Retry-After.
Unexpected server error.
Endpoint is registered but not implemented yet.