API ReferenceFetch Bulk

Bulk fetch URLs

Enqueues multiple URLs for fast-path HTTP fetching. Results delivered via webhook. Does not support browser-backed options (cookies, wait_for_selector, etc.).

POST
/v1/fetch/bulk

Authorization

AuthorizationRequiredBearer <token>

API key. Obtain from POST /v1/account/api-keys.

In: header

Request Body

application/jsonRequired
urlsRequiredarray<string | object>
defaultsobject
webhook_urlRequiredstring

Webhook endpoint URL (HTTPS only; http:// rejected with HTTP 422)

Pattern: "^https://"Format: "uri"
webhook_secretstring
metadataobject
curl -X POST "https://api.bytekit.com/v1/fetch/bulk" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "http://example.com"
    ],
    "defaults": {
      "format": "markdown",
      "country": "US",
      "cache_ttl": "48h"
    },
    "webhook_url": "http://example.com",
    "webhook_secret": "string",
    "metadata": {}
  }'

Fetch bulk job accepted.

{}

Fetch a URL (POST)

Same as GET /v1/fetch but with a JSON request body.

Get fetch bulk job status

Next Page