Handle retries, limits, and partial results

Recover from search errors while keeping retries and request usage predictable.

  • 8 min read
  • Scraper API
Handle search errors and retries

Overview

Validation, authentication, quota, and pre-admission capacity failures do not consume a request. A successful search uses one request unit, even if it returns no businesses. Terminal failed or canceled searches release their reservation. Partial successes use one request. An HTTP timeout may leave the original search processing with a request reserved; its final outcome determines whether it is charged. Test-key responses are simulated and free.

Usage

Check error.code and retryable. Honor Retry-After. Retry a timeout with the identical body and Idempotency-Key to avoid duplicate work or charges. Stop on validation, authentication, or quota failures. Each successful response contains up to 20 businesses; unavailable fields must not be invented.

See the Search API documentation for the current contract.

Keep going

Take the next step

Search business data

Get up to 20 businesses per API request.