API Reference

Scrape Bulk

Scrape Bulk API — endpoints, requests, and responses.

The Scrape Bulk API. 2 endpoints:

Bulk scrape URLs

POST /v1/scrape/bulk

Get scrape bulk job status

GET /v1/scrape/bulk/:id

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. Webhook deliveries include `X-ByteKit-Event: scrape.completed` or `X-ByteKit-Event: scrape.failed` so receivers can dispatch on the header without parsing the body shape.