Fetch

Low-latency raw HTTP fetch with optional conversion. Accessed via client.fetch.

create

client.fetch.create(opts: FetchOpts): Promise<unknown>

POST /v1/fetch — fetch URL content via POST body.

Returns content directly (not ID-based).

get

client.fetch.get(opts: FetchOpts): Promise<unknown>

GET /v1/fetch — fetch URL content via query params.

Returns content directly (not ID-based).

bulk

create

client.fetch.bulk.create(opts: Record<string, unknown>): Promise<unknown>

POST /v1/fetch/bulk — create a bulk fetch job

get

client.fetch.bulk.get(id: BulkId): Promise<unknown>

GET /v1/fetch/bulk/{id} — get a bulk fetch job

Options (FetchOpts)

• url (required) — string
• format — string
• country — string
• timeoutMs — number
• cacheTtl — number
• custom — Record<string, unknown> — User-supplied JSON payload, base64-encoded into the X-Fetch-Custom response header so callers can correlate the response to caller-side state. Capped at 4096 UTF-8 bytes after JSON serialization. Does NOT affect cache-key inputs.