API ReferenceBulk

List in-flight bulk jobs

Returns the caller's bulk jobs, most recent first. Optionally filter to a single status; when omitted, jobs of every status are returned.

GET
/v1/bulk

Authorization

AuthorizationRequiredBearer <token>

API key. Manage keys from the dashboard at app.bytekit.com.

In: header

Query Parameters

statusstring
Value in: "processing" | "completed" | "failed"
curl https://api.bytekit.com \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Successful response.

[
  {
    "id": "bulk_01j9abc123",
    "status": "processing",
    "total": 0,
    "completed": 0,
    "failed": 0,
    "created_at": "2019-08-24T14:15:22Z",
    "completed_at": "2019-08-24T14:15:22Z",
    "total_credits_charged": 0,
    "estimated_credits": 0,
    "webhook_url": "string"
  }
]

Bulk

Bulk API — endpoints, requests, and responses.

POST /v1/bulkCreate mixed bulk job

Enqueues screenshots or scrapes in a single batch. Provide `urls` (simple list) or `items` (per-item config), not both. Webhook deliveries include `X-ByteKit-Event: bulk.completed` so receivers can dispatch on the header without parsing the body shape.