Bulk lookup (≤100 creators)

post/creators/bulk

Request

  • Base URL: https://creatorscore.io/api/v1
  • URL: https://creatorscore.io/api/v1/creators/bulk
  • 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

cache_onlyboolean

When true, never trigger fresh scrapes for this batch. Cache hits return inline (flat cached fee each); misses return status='not_scored' instead of being queued. Lets a caller enrich a roster with existing scores without spending on scrapes.

Response

Per-creator result (cached / queued / error). Atomic credit accounting; duplicates within the same batch are charged once.

resultsobject[]

Changes

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