Search creators
Natural-language Instagram/TikTok creator search. Unsigned callers get 50 free searches per UTC day per IP; pre-claim agent tokens have no free grant, spend prepaid only; claimed/session/Settings-key callers spend prepaid or 100 free searches per UTC day on empty balance. Past free credits, caller gets HTTP 402 (out_of_credits) with WWW-Authenticate: Payment. Paid retries must send identity as x-api-key and settled credential as Authorization: Payment (not Bearer). Dry-run: ?force_payment=1 returns non-charging 402 challenge. Payment credential with remaining entitlement routes through paywall (never silent 200). Rejected Payment credentials return application/problem+json, not OutOfCredits JSON.
Headers
Identity for identified search; required on MPP paid retries alongside Authorization: Payment.
MPP Payment credential after settling a 402 challenge. Must be paired with x-api-key.
Query Parameters
ig, tt nano, micro, mid, macro, mega us, gb, ca, au, de, fr, br, jp, kr, in Docs dry-run: when set to 1 with an identified caller, returns a non-charging 402 Payment challenge.
1