Scrape Bulk
Scrape Bulk API — endpoints, requests, and responses.
For AI agents: https://bytekit.com/llms.txt — every docs page is available as markdown by appending .md
The Scrape Bulk API. 2 endpoints:
GET /v1/scrape/{id}Get scrape result
Always returns 200. Check the `status` discriminator for the scrape state.
POST /v1/scrape/bulkBulk scrape URLs
Enqueues multiple URLs for scraping. Results delivered via webhook. Completion deliveries use `X-ByteKit-Event: bulk.completed` and the `BulkCompletedWebhook` contract: at most 500 complete items and 1 MiB, followed by cursor recovery through `GET /v1/scrape/bulk/{id}` whenever `recovery_required` is true. **Unknown keys.** An unknown key on an `items[]` entry, or at the top level of the body, is rejected with `422 validation_error`. An unknown key inside `defaults` is not: it is dropped without a warning and the request is accepted with `202`. The exception is `cookies` and `headers`, on an item or in `defaults`: they answer `400 validation_error`.