Expand AI logo
DocsAPI ReferenceAPI Reference
Glow Active
Login

API Reference

Getting Started

API ReferenceRate LimitingError Handling

Endpoints

Start Batched FetchCancel Batched FetchFetchFetch JSON ModeHighlightsGet Batched Status
Browse docs

Getting Started

API ReferenceRate LimitingError Handling

Endpoints

Start Batched FetchCancel Batched FetchFetchFetch JSON ModeHighlightsGet Batched Status

Start Batched Fetch

Start a Batched Fetch over multiple URLs using shared Fetch input and Include Options. Search is not supported for Batched Fetch requests.

Authorization

x-expand-api-key<token>

In: header

Header Parameters

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

POST
/v1/fetch/batched
x-idempotency-key?maxLength(255)

Optional caller-supplied key that prevents duplicate Batched Fetch runs across separate calls. When omitted, the API generates a unique key. Replaying an identical request with the same key returns the same run ID; reusing the key with a different payload returns a 409 response.

Length1 <= length <= 255
urls*array<string>
Items1 <= items
include?
browserConfig?

application/json

application/json

application/json

application/json

application/json

application/json

application/json

{
  "id": "string"
}
{
  "issues": [
    {
      "_tag": "Pointer",
      "path": [
        "string"
      ],
      "message": "string"
    }
  ],
  "

{
  "reason": "InvalidApiKey",
  "description": "string",
  "_tag": "AuthFailed"
}
{
  "organizationId": "string",
  "blockedUntil": "string",
  "_tag": "AccessBlocked"
}
{
  "existingRunId": "string",
  "reason": "payload_mismatch",
  "_tag": "BatchedIdempotencyConflict"
}
{
  "_tag": "PayloadTooLarge"
}
{
  "_tag": "TooManyRequests"
}
{
  "_tag": "InternalError"
}
{
  "message": "string",
  "requestId": "string",
  "_tag": "ServiceUnavailable"
}

List of URLs to fetch using shared options.

Specifies which content formats to include in the response

Configuration options for browser behavior during the fetch

message
"
:
"string"
,
"_tag": "HttpApiDecodeError"
}