Errors and limits

Error response

Errors contain only the request correlation ID and error details:

{
  "requestId": "req_crops_01",
  "error": {
    "code": "invalid_message",
    "message": "images must contain at least one non-empty URL"
  }
}

Status	Code	Meaning
`400`	`invalid_message`	Missing fields, unknown fields, invalid JSON, or no usable image URL.
`400`	`invalid_image`	An Image Edit input could not be fetched or decoded.
`401`	`unauthorized`	Missing, invalid, or expired API key.
`403`	`image_edit_not_enabled`	Image Edit is not enabled for this API key.
`429`	`rate_limit`	This operation’s RPM bucket is exhausted.
`500`	`internal_error`	Authentication or processing infrastructure failed.
`502`	`past_coin_search_failed`	The selected past-coin search provider failed.
`502`	`image_edit_failed`	The image edit failed.
`503`	`image_edit_busy`	Image editing is at capacity.
`503`	`image_edit_unavailable`	Image editing is temporarily unavailable.

Independent rate limits

Each operation has its own per-user minute bucket:

Operation	Endpoint	Weight
AI Name	`POST /private/ai_name`	`1`
Past Coins	`POST /private/past_coins`	`1`
Crops	`POST /private/crops`	`1`
OCR	`POST /private/ocr`	`1`
Image Edit	`POST /private/image_edit`	`1`

Using one bucket does not consume another. The weighted limiter can support higher-cost operations in the future; all current requests cost one unit. Image Edit uses its own per-minute limit instead of your RPM limit: 6 per minute on Basic and 60 per minute on Pro. Image editing capacity is shared by all accounts, so a request can return image_edit_busy before you reach your limit. A request rejected as busy still counts toward your Image Edit limit.

Scrapist does not currently send quota headers or Retry-After. Pace each operation in your backend and add jitter when retrying rate_limit.

Timeouts and retries

Use a client deadline of at least 120 seconds. Scrapist waits for the operation internally and returns the results available at its terminal deadline; there is no completion field in the public response.

Failure	Retry unchanged?	Recommended behavior
Invalid or expired key	No	Fix the credential or contact support.
`invalid_message`	No	Match the route’s documented request shape.
`rate_limit`	Later	Wait for that operation’s minute bucket.
`internal_error`	Yes, bounded	Retry the same AI Name event; for image routes, reuse `requestId`. Apply backoff with jitter.
`past_coin_search_failed`	Yes, bounded	Retry the same query and provider array. Reuse `requestId` when supplied.
`invalid_image`	No	Send a public `http(s)` image URL or a base64 image data URL.
`image_edit_not_enabled`	No	Contact support to enable Image Edit for your key.
`image_edit_busy` or `image_edit_unavailable`	Yes, bounded	Wait a few seconds, then retry with backoff and jitter.
`image_edit_failed`	Yes, bounded	Retry the same prompt and images. Apply backoff with jitter.
Network failure	Yes, bounded	Retry the same AI Name event; for image routes, reuse `requestId`. Apply backoff with jitter.

Get support

24/7 Discord support

Contact the Scrapist team for credential exposure, persistent failures, or integration questions.

Get started

API reference

Reference

Errors and limits

Error response

Independent rate limits

Timeouts and retries

Get support

24/7 Discord support

​Error response

​Independent rate limits

​Timeouts and retries

​Get support

24/7 Discord support

Error response

Independent rate limits

Timeouts and retries

Get support