Start a Social Background Check (Quick or Verified, $29.99, paid via Stripe — not credits)

Starts a Social Background Check: a one-shot, full-history brand-safety scan producing a categorized report of findings (hate/NSFW/violence/profanity/political/legal and more), each with evidence. NO SCORE IS PRODUCED — a Background Check is a distinct product from the CreatorScore. Billing is a one-time Stripe payment, NOT API credits: the response returns a payment_url the brand completes in the browser. Tiers: QUICK ($29.99 / €27.99, default) scans public history and starts automatically when payment clears. VERIFIED ($29.99 / €27.99, tier:'verified') adds creator-authorized content (OAuth-pulled posts, dense video frames, transcripts, deleted-content recovery) and requires creator_email: after payment the creator is emailed a consent link, the check waits in status 'awaiting_consent' until they authorize, then the scan runs; it is auto-refunded if they never do. Full-scope key required.

post/background-checks

Request

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

Request body

handlestring required
platformsstring[] required

Platforms to scan.

creator_namestring
currency'usd' | 'eur'
tier'quick' | 'verified'

verified requires creator_email; the creator must consent before the scan runs.

creator_emailstring email

Verified tier only: where the consent link is sent.

consent_reasonsstring

Verified tier only: shown to the creator in the consent request.

provided_handlesobject

Optional per-platform handles for platforms fetched by handle rather than OAuth (e.g. twitter).

Response

check_id + status='awaiting_payment' + tier + amount (cents) + currency + payment_url + platforms (+ creator_email for verified). After payment: quick → 'processing' → 'completed'; verified → 'awaiting_consent' → 'processing' → 'completed' (or refunded if the creator never authorizes). Poll GET /background-checks/{id}.

object required

Changes

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