Fetch a URL

const options = {
  method: 'POST',
  headers: {'X-Browser-Use-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://example.com',
    method: 'GET',
    headers: {},
    body: JSON.stringify('<string>'),
    body_base64: '<string>',
    content_type: '<string>',
    output_format: 'raw',
    follow_redirects: true,
    max_redirects: 10,
    timeout_ms: 30000,
    session_id: '<string>',
    proxy_country: 'US',
    retry: {count: 3, on_status: [500, 502, 503, 504], backoff_ms: 100},
    insecure_skip_verify: false
  })
};

fetch('https://api.browser-use.com/api/v3/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://api.browser-use.com/api/v3/fetch \
  --header 'Content-Type: application/json' \
  --header 'X-Browser-Use-API-Key: <api-key>' \
  --data '
{
  "url": "https://example.com",
  "method": "GET",
  "headers": {},
  "body": "<string>",
  "body_base64": "<string>",
  "content_type": "<string>",
  "output_format": "raw",
  "follow_redirects": true,
  "max_redirects": 10,
  "timeout_ms": 30000,
  "session_id": "<string>",
  "proxy_country": "US",
  "retry": {
    "count": 3,
    "on_status": [
      500,
      502,
      503,
      504
    ],
    "backoff_ms": 100
  },
  "insecure_skip_verify": false
}
'

import requests

url = "https://api.browser-use.com/api/v3/fetch"

payload = {
    "url": "https://example.com",
    "method": "GET",
    "headers": {},
    "body": "<string>",
    "body_base64": "<string>",
    "content_type": "<string>",
    "output_format": "raw",
    "follow_redirects": True,
    "max_redirects": 10,
    "timeout_ms": 30000,
    "session_id": "<string>",
    "proxy_country": "US",
    "retry": {
        "count": 3,
        "on_status": [500, 502, 503, 504],
        "backoff_ms": 100
    },
    "insecure_skip_verify": False
}
headers = {
    "X-Browser-Use-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status_code": 123,
  "status": "<string>",
  "headers": {},
  "body": "<string>",
  "body_base64": "<string>",
  "is_binary": true,
  "final_url": "<string>",
  "redirect_count": 123,
  "protocol": "<string>",
  "error": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

POST

fetch

Fetch a URL

const options = {
  method: 'POST',
  headers: {'X-Browser-Use-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    url: 'https://example.com',
    method: 'GET',
    headers: {},
    body: JSON.stringify('<string>'),
    body_base64: '<string>',
    content_type: '<string>',
    output_format: 'raw',
    follow_redirects: true,
    max_redirects: 10,
    timeout_ms: 30000,
    session_id: '<string>',
    proxy_country: 'US',
    retry: {count: 3, on_status: [500, 502, 503, 504], backoff_ms: 100},
    insecure_skip_verify: false
  })
};

fetch('https://api.browser-use.com/api/v3/fetch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://api.browser-use.com/api/v3/fetch \
  --header 'Content-Type: application/json' \
  --header 'X-Browser-Use-API-Key: <api-key>' \
  --data '
{
  "url": "https://example.com",
  "method": "GET",
  "headers": {},
  "body": "<string>",
  "body_base64": "<string>",
  "content_type": "<string>",
  "output_format": "raw",
  "follow_redirects": true,
  "max_redirects": 10,
  "timeout_ms": 30000,
  "session_id": "<string>",
  "proxy_country": "US",
  "retry": {
    "count": 3,
    "on_status": [
      500,
      502,
      503,
      504
    ],
    "backoff_ms": 100
  },
  "insecure_skip_verify": false
}
'

import requests

url = "https://api.browser-use.com/api/v3/fetch"

payload = {
    "url": "https://example.com",
    "method": "GET",
    "headers": {},
    "body": "<string>",
    "body_base64": "<string>",
    "content_type": "<string>",
    "output_format": "raw",
    "follow_redirects": True,
    "max_redirects": 10,
    "timeout_ms": 30000,
    "session_id": "<string>",
    "proxy_country": "US",
    "retry": {
        "count": 3,
        "on_status": [500, 502, 503, 504],
        "backoff_ms": 100
    },
    "insecure_skip_verify": False
}
headers = {
    "X-Browser-Use-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "status_code": 123,
  "status": "<string>",
  "headers": {},
  "body": "<string>",
  "body_base64": "<string>",
  "is_binary": true,
  "final_url": "<string>",
  "redirect_count": 123,
  "protocol": "<string>",
  "error": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

{
  "error": "<string>",
  "code": 123,
  "details": "<string>"
}

Authorizations

X-Browser-Use-API-Key

string

header

required

Body

application/json

url

string<uri>

required

Target URL.

Example:

"https://example.com"

method

enum<string>

default:GET

HTTP method.

Available options:

GET,

POST,

PUT,

PATCH,

DELETE,

HEAD,

OPTIONS

headers

object

Additional HTTP headers.

Show child attributes

body

string

Request body as text.

body_base64

string

Request body as base64, for binary content.

content_type

string

Override the Content-Type header.

output_format

enum<string>

default:raw

How to format the response body. raw returns the page unchanged; markdown returns clean readable text; structured returns a parsed object (title, links, headings, tables); simplified strips boilerplate.

Available options:

raw,

markdown,

structured,

simplified

follow_redirects

boolean

default:true

Follow HTTP redirects.

max_redirects

integer

default:10

Maximum redirects to follow.

timeout_ms

integer

default:30000

Request timeout in milliseconds.

Required range: x <= 120000

session_id

string

Session ID. Requests sharing a session persist cookies and the proxy IP across calls.

proxy_country

string

default:US

ISO 3166-1 alpha-2 country code for proxy routing (e.g. DE).

retry

object

Retry behavior for failed requests.

Show child attributes

insecure_skip_verify

boolean

default:false

Skip TLS certificate verification.

Response

The fetched response.

status_code

integer

HTTP status code.

status

string

Full status string (e.g. "200 OK").

headers

object

Response headers. Each value is a list of strings.

Show child attributes

body

string

Response body as text.

body_base64

string

Response body as base64, when binary.

is_binary

boolean

Whether the response is binary content.

final_url

string

Final URL after redirects.

redirect_count

integer

Number of redirects followed.

protocol

string

HTTP protocol version (e.g. "HTTP/2.0").

error

string

Error message if the request failed.

Search the web

⌘I

Get Started

Endpoints

Fetch a URL

Authorizations

Body

Response