> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# v1 (legacy)

API v1 still runs for older integrations but isn't documented here; new work should use v2.

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](https://docs.scrapier.io/credits-and-pricing.md).
- 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

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](https://docs.scrapier.io/pagination.md).
5. Check endpoint names and parameters against the [API reference](https://docs.scrapier.io/api-reference.md) or `GET /endpoints`. A few v1 endpoints have no v2 equivalent.

> **Tip:** The n8n node (1.1.0 and later), the Zapier app (2.0.0 and later) and the MCP server already use v2. Upgrading them is the migration.
