v1 (legacy)
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.
Migrating to v2
Section titled “Migrating to v2”- Change the base URL from
/api/v1/to/api/v2/. Keep theX-API-Keyheader and the trailing slash. - Read results from
datain{"success": true, "data": {...}}. The result key is named on each endpoint page. - Drop any job or webhook handling.
- Page with
cursor: passdata.next_cursorback until it isnull. See Pagination. - Check endpoint names and parameters against the API reference or
GET /endpoints. A few v1 endpoints have no v2 equivalent.