Your first request

Understand submission, polling, and result retrieval.

  1. Submit a POST /api/v1/data/requests request with a URL and route preferences.
  2. Poll GET /api/v1/data/requests/{id} until the job reaches a terminal state. Use backoff; do not hammer the status endpoint.
  3. Retrieve GET /api/v1/data/requests/{id}/result after success.
  4. Validate the result in your application before persisting or serving it.

Use Idempotency-Key on submission so a network retry does not accidentally create duplicate work. Do not assume that a submitted request is complete, and do not treat a non-2xx response as a result payload.

Last updated on

Getting started

The shortest path from an API key to a reliable result.