Get fetch bulk job status

Returns the job envelope plus its per-URL items.

Downloading item content. Each completed item's content_url is a pre-signed URL, minted fresh on every read of this endpoint and valid for 600 seconds (10 minutes) — the same signing lifetime as the image_url returned by GET /v1/bulk/{id}/screenshots. The underlying objects are private, so an unsigned URL returns 401: download the content inside that window, or re-poll this endpoint for a fresh signature. Items that are not completed, and completed items with no stored object, or completed items whose object cannot be signed, carry null; the latter report artifact_unavailable. The private unsigned storage URL is never returned.

Cancelled by the platform. When the account can no longer spend (its bandwidth balance is exhausted, or the account is deleted) while items are still pending, ByteKit cancels the job itself. It then reads status: cancelled even though you never called DELETE /v1/bulk/{id}, and the cancellation sends no webhook.

Job ids from other create routes. The job is looked up by account only, so the id of a job created by POST /v1/scrape/bulk or POST /v1/bulk is found here too, not a 404, with the job envelope and items: []: only items fetched through POST /v1/fetch/bulk are listed. An id from another account answers 404.

curl https://api.bytekit.com/v1/fetch/bulk/{id} \
  -H "Authorization: Bearer sk_live_your_api_key_here"

{
  "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,
  "total_billed_bytes": 0,
  "estimated_credits": 0,
  "webhook_url": "string",
  "next_cursor": "string",
  "has_more": true,
  "items": [
    {
      "id": "sc_01j9abc123",
      "url": "http://example.com",
      "status": "pending",
      "content_type": "string",
      "content_length": 0,
      "content_url": "string",
      "waf_vendor": "string",
      "cache_hit": true,
      "billing": {
        "raw_bytes": 1024,
        "factors": [
          {
            "name": "endpoint",
            "value": 1.5,
            "reason": "scrape_md"
          }
        ],
        "multiplier": 0.75,
        "billed_bytes": 768
      },
      "error_code": "string",
      "error_message": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "completed_at": "2019-08-24T14:15:22Z"
    }
  ]
}