Find thought leaders for a topic
POST/v1/creators/thought-leaders
Start an async thought leaders job for a topic. Requires at least 5 keywords. Runs discovery, enrichment refresh, and recent-post content validation. Poll GET /v1/jobs/{job_id} and fetch results via POST /v1/jobs/results when status is terminal. Credits are reserved up front from max_candidates_to_analyze and mode (broad: 1, balanced: 2, strict: 3 credits per creator analyzed); unused credits are refunded after completion.
Request
Responses
- 202
- 400
- 401
- 402
- 403
- 404
- 429
- 500
- 501
Job accepted. Poll job status and results endpoints until terminal.
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.