Skip to content

These docs cover API v2 only: https://api.scrapier.io/api/v2.

API v1 (/api/v1/) still exists so that older connectors keep working. It isn’t documented here, and new projects shouldn’t use it. The main differences:

  • v1 is billed per result row. v2 costs the endpoint’s credit price per successful call, whatever the number of rows. See Credits & pricing.
  • Some v1 endpoints run as background jobs, with job IDs to check and optional webhooks. v2 has none of that: every call answers in the same request.
  1. Change the base URL from /api/v1/ to /api/v2/. Keep the X-API-Key header and the trailing slash.
  2. Read results from data in {"success": true, "data": {...}}. The result key is named on each endpoint page.
  3. Drop any job or webhook handling.
  4. Page with cursor: pass data.next_cursor back until it is null. See Pagination.
  5. Check endpoint names and parameters against the API reference or GET /endpoints. A few v1 endpoints have no v2 equivalent.