> ## Documentation Index
> Fetch the complete documentation index at: https://browseruse-0aece648-reagan-eng-5397-make-docs-better-for-ag.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a URL

> Execute an HTTP request through Browser Use's proxy infrastructure with Chrome TLS fingerprinting, so the request looks like genuine browser traffic.



## OpenAPI

````yaml /cloud/openapi/v3.json post /fetch
openapi: 3.1.0
info:
  title: Browser Use Public API v3
  summary: Browser Use session-based agent API (v3)
  version: 3.0.0
servers:
  - url: https://api.browser-use.com/api/v3
    description: Production server
security: []
paths:
  /fetch:
    post:
      tags:
        - Fetch
      summary: Fetch a URL
      description: >-
        Execute an HTTP request through Browser Use's proxy infrastructure with
        Chrome TLS fingerprinting, so the request looks like genuine browser
        traffic.
      operationId: fetch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FetchRequest'
      responses:
        '200':
          description: The fetched response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchResponse'
        '400':
          description: Missing or invalid request (e.g. no `url`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
        '402':
          description: Insufficient balance.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
        '403':
          description: 'Request blocked (e.g. SSRF protection: private/internal address).'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
        '502':
          description: The upstream request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
        '503':
          description: Authentication or balance service temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FetchError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    FetchRequest:
      type: object
      required:
        - url
      properties:
        url:
          type: string
          format: uri
          description: Target URL.
          example: https://example.com
        method:
          type: string
          enum:
            - GET
            - POST
            - PUT
            - PATCH
            - DELETE
            - HEAD
            - OPTIONS
          default: GET
          description: HTTP method.
        headers:
          type: object
          additionalProperties:
            type: string
          description: Additional HTTP headers.
        body:
          type: string
          description: Request body as text.
        body_base64:
          type: string
          description: Request body as base64, for binary content.
        content_type:
          type: string
          description: Override the Content-Type header.
        output_format:
          type: string
          enum:
            - raw
            - markdown
            - structured
            - simplified
          default: raw
          description: >-
            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.
        follow_redirects:
          type: boolean
          default: true
          description: Follow HTTP redirects.
        max_redirects:
          type: integer
          default: 10
          description: Maximum redirects to follow.
        timeout_ms:
          type: integer
          default: 30000
          maximum: 120000
          description: Request timeout in milliseconds.
        session_id:
          type: string
          description: >-
            Session ID. Requests sharing a session persist cookies and the proxy
            IP across calls.
        proxy_country:
          type: string
          default: US
          description: ISO 3166-1 alpha-2 country code for proxy routing (e.g. `DE`).
        retry:
          $ref: '#/components/schemas/FetchRetryConfig'
        insecure_skip_verify:
          type: boolean
          default: false
          description: Skip TLS certificate verification.
    FetchResponse:
      type: object
      properties:
        status_code:
          type: integer
          description: HTTP status code.
        status:
          type: string
          description: Full status string (e.g. "200 OK").
        headers:
          type: object
          additionalProperties:
            items:
              type: string
            type: array
          description: Response headers. Each value is a list of strings.
        body:
          type: string
          description: Response body as text.
        body_base64:
          type: string
          description: Response body as base64, when binary.
        is_binary:
          type: boolean
          description: Whether the response is binary content.
        final_url:
          type: string
          description: Final URL after redirects.
        redirect_count:
          type: integer
          description: Number of redirects followed.
        protocol:
          type: string
          description: HTTP protocol version (e.g. "HTTP/2.0").
        error:
          type: string
          description: Error message if the request failed.
    FetchError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message.
        code:
          type: integer
          description: HTTP status code.
        details:
          type: string
          description: Additional error details.
    FetchRetryConfig:
      type: object
      description: Retry behavior for failed requests.
      properties:
        count:
          type: integer
          description: Number of retry attempts.
          default: 3
        on_status:
          type: array
          items:
            type: integer
          description: Status codes that trigger a retry.
          default:
            - 500
            - 502
            - 503
            - 504
        backoff_ms:
          type: integer
          description: Initial backoff in milliseconds (exponential).
          default: 100
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-Browser-Use-API-Key

````