Fetch a Page

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

POST /v1/fetch

Fetch a Page

cURL

curl --request POST \
  --url https://api.browserbase.com/v1/fetch \
  --header 'Content-Type: application/json' \
  --header 'X-BB-API-Key: <api-key>' \
  --data '
{
  "url": "<string>",
  "allowRedirects": false,
  "allowInsecureSsl": false,
  "proxies": false,
  "format": "raw",
  "schema": {}
}
'

200

{
  "id": "<string>",
  "statusCode": 123,
  "headers": {},
  "content": "<string>",
  "contentType": "<string>",
  "encoding": "<string>"
}

Authorizations

X-BB-API-Key · string · header · required

Your Browserbase API Key.

Body

application/json

url · string<uri> · required

The URL to fetch

allowRedirects · boolean · default: false

Whether to follow HTTP redirects

allowInsecureSsl · boolean · default: false

Whether to bypass TLS certificate verification

proxies · boolean · default: false

Whether to enable proxy support for the request

format · Option 1 · enum<string> Option 2 · enum<string> Option 3 · enum<string> · default: raw

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.

Available options: raw

schema · object

JSON Schema describing the desired structure of the response. Only used when format is json.

Show child attributes

Response

200

application/json

The request has succeeded.

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

Show child attributes

content · string object · required

The response body content. A string for raw and markdown formats; a structured object for json format (the schema-extracted result).

contentType · string · required

The MIME type of the response

encoding · string · required

The character encoding of the response