Vet one creator across all their accounts (unified)
Cross-platform vetting in one call. Provide the same creator's handles across platforms; returns the unified CreatorScore (the official cross-platform FICO when the accounts are linked in an identity group, otherwise a clearly-labeled follower-weighted estimate), the per-platform breakdown, and the worst risk flags found on any account. CACHED-ONLY: never scrapes. Accounts with no recent cached score return status='not_scored' (no charge). BILLING: 1 credit per DISTINCT creator delivered — one creator's accounts across any number of platforms cost 1 credit total; unrelated creators in the same call are each billed their own credit (same rate as /creators/bulk). A creator already on your roster with a fresh copy is free.
Request
- Base URL: https://creatorscore.io/api/v1
- URL: https://creatorscore.io/api/v1/creators/vet
- Auth: API key in header X-API-Key
Headers
Makes retries safe on charged POSTs. Same key + same body replays the stored 2xx with Idempotency-Replay: true (nothing re-runs or re-charges); same key + different body -> 422 idempotency_key_reused; retry mid-flight -> 409 idempotency_in_flight. Non-2xx outcomes are not stored. Keys expire after 24h.
Your own end-customer identifier for this read (a credit licenses ONE end-customer's evaluation of ONE creator). Logged with the request so per-brand usage is reconcilable on both sides. Opaque to us.
Request body
Response
Unified score (+ source/note), unified_scored_at + unified_score_age_days + unified_is_stale (with a rescore_hint when stale), per-account breakdown (each cached account includes last_scored_at + score_age_days), worst_risks, and a summary with credits charged.
Changes
No recorded changes to this operation across all 1 revision of this API.