TikTok, Instagram, and X are live. Sign up for 150 free credits.
Fluxcrawl

Errors

Every error code Fluxcrawl returns, and what actually triggers each one.

A failed request returns a non-2xx status and this body:

{
  "success": false,
  "error": { "code": "RESOURCE_NOT_FOUND", "message": "..." }
}
CodeHTTP statusMeaning
INVALID_API_KEY401Missing, malformed, or revoked X-API-Key. See Authentication.
INVALID_REQUEST400A required parameter is missing, or the endpoint name in the URL doesn't exist.
RESOURCE_NOT_FOUND404The upstream platform confirmed the thing you asked for (a profile, a post) doesn't exist.
RATE_LIMITED429The provider serving this request is rate-limiting you right now.
PROVIDER_UNAVAILABLE503Every provider in the fallback chain for this platform/endpoint failed. Not billed, see below.
INSUFFICIENT_CREDITS402Either your account balance or this specific key's own credit limit (if you set one) is exhausted. Nothing is attempted upstream, so this never costs you anything. Buy more credits from your Billing page, or raise the key's limit from the dashboard.

PROVIDER_UNAVAILABLE and fallback

This is the one code that's genuinely load-bearing, not just a placeholder. Each platform/endpoint pair is served by an ordered list of providers. When one fails with something that means "this provider can't answer right now," Fluxcrawl automatically retries the next one in the chain. You only see PROVIDER_UNAVAILABLE if every provider in the chain failed.

This also covers a provider being fundamentally unable to serve a given endpoint, not just downtime. Some endpoints are only supported by one provider in a chain, and the others decline automatically rather than returning the wrong kind of data. You never see that distinction from the outside; you just get a correct answer.

Any other error code (INVALID_REQUEST, RESOURCE_NOT_FOUND, RATE_LIMITED) is treated as that provider's real answer, not a reason to try the next one. A 404 means the profile doesn't exist, not that the provider is broken.

On this page