Discover a creator's accounts across platforms (from one handle)

Identity discovery: given ONE account, find the creator's other accounts across platforms by reading the seed's bio (link-in-bio + cross-references) and verifying matches with Google-Search-grounded inference. Returns each account with a confidence (0-1) and source. Does NOT score — pair with POST /creators/vet to score the footprint. Costs the discovery credit shown on GET /account (one live profile fetch + one web-grounded lookup) and counts against the daily discovery caps. Full-scope key required. If the daily discovery budget is exhausted, the call still returns the creator's self-declared link-in-bio accounts, sets grounded_search_skipped=true, and charges NOTHING — treat the platforms it didn't reach as UNKNOWN, not as absent.

post/creators/discover

Request

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

Headers

Idempotency-Keystring

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.

X-Customer-Refstring

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

platform'tiktok' | 'instagram' | 'youtube' | 'twitter' | 'twitch' | 'facebook' | 'linkedin' | 'snapchat' | 'kick' | 'reddit' | 'threads' required

Platform of the seed handle.

handlestring required
min_confidencenumber

Drop discovered accounts below this confidence.

Response

seed + footprint[] (each with platform, handle, confidence, source, scoreable) + credits_charged.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.