---
title: "Fetch a Page"
method: POST
path: "/v1/fetch"
---

# Fetch a Page

`POST /v1/fetch`

Fetch a page and return its content, headers, and metadata.

## Request body

- object
  - `url` string, uri, required — The URL to fetch
  - `allowRedirects` boolean — Whether to follow HTTP redirects
  - `allowInsecureSsl` boolean — Whether to bypass TLS certificate verification
  - `proxies` boolean — Whether to enable proxy support for the request
  - `format` union — Output format for the response content. `raw` (default) returns the response body unchanged; `json` returns structured data (requires `schema`); `markdown` returns the page as markdown.
    - 'raw'
    - 'json'
    - 'markdown'
  - `schema` object — JSON Schema describing the desired structure of the response. Only used when `format` is `json`.

## Response `200`

The request has succeeded.

- object
  - `id` string, required — Unique identifier for the fetch request
  - `statusCode` integer, required — HTTP status code of the fetched response
  - `headers` object, required — Response headers as key-value pairs
  - `content` union, required — The response body content. A string for `raw` and `markdown` formats; a structured object for `json` format (the schema-extracted result).
    - string
    - object
  - `contentType` string, required — The MIME type of the response
  - `encoding` string, required — The character encoding of the response

## Other responses

- `400` — Invalid request body, or the requested `format` is not supported for the fetched response's content type.
- `402` — Free plan quota exceeded for the requested format.
- `403` — Project is not enabled for the requested format. Only `raw` is available without enablement.
- `429` — Concurrent fetch request limit exceeded.
- `502` — The fetched response was too large or TLS certificate verification failed.
- `503` — The fetch service is temporarily unavailable.
- `504` — The fetch request timed out.

---

[API](https://skmtc.net/browserbase/apis/browserbase-api.md) · [All operations](https://skmtc.net/browserbase/apis/browserbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/browserbase/browserbase-api/versions/832b22144edf/schema)