Expand AI logo
DocsAPI ReferenceAPI Reference
Glow Active
Login

API Reference

Getting Started

API ReferenceErrors

Endpoints

FetchFetch JSON ModeStart Batched FetchGet Batched StatusCancel Batched FetchGet CatalogSnapshot Highlights
Browse docs

Getting Started

API ReferenceErrors

Endpoints

FetchFetch JSON ModeStart Batched FetchGet Batched StatusCancel Batched FetchGet CatalogSnapshot Highlights

Fetch

POST
/v1/fetch

Fetch a URL and return an LLM-ready Markdown document. Use Include Options to request Appendix or State JSON when you need more evidence.

Authorization

x-expand-api-key<token>

In: header

Query Parameters

include?string
appendixMarkers?string
Value in"off" | "compact" | "detailed"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

text/markdown

application/json

Include Options for the response. Use a comma-separated list with appendix for Appendix and statejson for State JSON. Defaults to State JSON when omitted; use include= for Markdown only. For Highlights requests without a URL include parameter, the request body include fields define the Highlights corpus.

Appendix omission marker verbosity in the Markdown body: compact (default), detailed, or off. Overrides include.appendixMarkers from the request body.

url*string
include?
highlights?
browserConfig?
documentConfig?

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

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


{
  "reason": "InvalidApiKey",
  "description": "string",
  "_tag": "AuthFailed"
}
{
  "organizationId": "string",
  "blockedUntil": "string",
  "_tag": "AccessBlocked"
}
{
  "_tag": "FetchOriginHttpError",
  "url": "string",
  "statusCode": 404,
  "contentType": "text/html"
}
{
  "_tag": "FetchOriginHttpError",
  "url": "string",
  "statusCode": 410,
  "contentType": "text/html"
}
{
  "_tag": "PayloadTooLarge"
}
{
  "url": "string",
  "contentType": "application/octet-stream",
  "_tag": "FetchUnsupportedContentType"
}
{
  "url": "string",
  "availability": "private",
  "message": "string",
  "_tag": "FetchVideoUnavailable"
}
{
  "retryable": true,
  "retryAfterSeconds": 0,
  "_tag": "TooManyRequests"
}
{
  "retryable": true,
  "_tag": "InternalError"
}
{
  "url": "string",
  "failureType": "pageNeverSettled",
  "retryable": false,
  "_tag": "FetchCaptureFailed"
}
{
  "message": "string",
  "requestId": "string",
  "dispatchOutcome": "cancelled_before_start",
  "retryable": true,
  "_tag": 

{
  "url": "string",
  "timeoutMs": 150000,
  "retryable": false,
  "_tag": "FetchCaptureTimeout"
}
{
  "url": "string",
  "timeoutMs": 150000,
  "retryable": true,
  "_tag": "FetchCapacityTimeout"
}

The URL to fetch content from (http or https only)

Specifies which content formats to include in the response

Options for Highlights. When present, Fetch returns relevant passages.

Configuration options for browser behavior during the fetch

Limits and conversion options applied when the URL serves a non-HTML document

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