Start audience match analysis
POST/v1/creators/audience-match
Start LinkedIn audience-fit analysis for a creator selection. Requires a user-scoped key.
Selection (provide exactly one): creator_ids, result_set_id, or result_set_ids.
Audience criteria: for ad hoc runs (no campaign_id) provide at least one of campaign_brief, target_audience, audience_keywords (array), or target_audience_criteria (array). When campaign_id is set, criteria are read from the campaign.
Returns 202 with prefixed job IDs in the form audience-fit:<uuid>. Use those IDs with POST /v1/audience-match/results or /details. Cost: 10/20/30 credits per analysis based on analysis_depth.
Request
Responses
- 202
- 400
- 401
- 402
- 403
- 404
- 429
- 500
- 501
Audience match jobs queued. Job IDs are prefixed audience-fit:<uuid>.
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.