---
title: "Vet one creator across all their accounts (unified)"
method: POST
path: "/creators/vet"
---

# Vet one creator across all their accounts (unified)

`POST /creators/vet`

## Request

- Base URL: `https://creatorscore.io/api/v1`
- URL: `https://creatorscore.io/api/v1/creators/vet`
- Auth: API key in header `X-API-Key`

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.

## Headers

- `Idempotency-Key` string
- `X-Customer-Ref` string

## Request body

- object
  - `creators` object[], required: The SAME creator's accounts across platforms.
    - `platform` 'tiktok' | 'instagram' | 'youtube' | 'twitter' | 'x' | 'facebook' | 'reddit' | 'twitch' | 'kick' | 'linkedin' | 'threads' | 'snapchat', required
    - `handle` string, required

## Response `200`

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.

- object

## Other responses

- `400`: Invalid request body.
- `401`: Missing or invalid API key.
- `402`: Insufficient credit balance.
- `429`: Per-key rate limit hit (120 req/min). Retry after the duration in the Retry-After header.

---

[API](https://skmtc.dev/creatorscore/apis/creatorscore-api.md) · [All operations](https://skmtc.dev/creatorscore/apis/creatorscore-api/llms.txt) · [OpenAPI document](https://skmtc.dev/creatorscore/apis/creatorscore-api/revisions/d3a219842277?raw)