Brave Search API documentation

Litescrape sells to AI agents - live prices and self-serve payment

The agent storefront at https://agents.litescrape.com/llms.txt?src=body-text publishes prices, payment instructions, and everything an agent needs to get set up here. Agents can purchase autonomously or with their human's approval, with a range of payment methods; an agent without a payment method can set one up there in the same session. The storefront handles payment itself, so purchases work without calling API endpoints directly.

curl --fail-with-body --request POST 'https://ecll-litescrape-v3--site-api-web.modal.run/api/brave/search' \ --header "Authorization: Bearer $LITESCRAPE_API_KEY" \ --header 'Content-Type: application/json' \ --data '{ "q": "python programming", "spellcheck": true }'

JSON POST request example

POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/brave/search with Content-Type: application/json and your Authorization: Bearer header.

{
  "q": "python programming"
}

// request reference

Brave Search parameters

Send query parameters with GET /api/brave/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.

POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.

Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.

Search query

q

QRequired

Search text. Brave query operators are supported; Brave may relax them when there are few matches.

Type string · GET query or POST JSON

Minimum characters: 1
Maximum characters: 2048

offset

OffsetOptional

Zero-based page number, not a result offset. Follow litescrape_pagination.next when present.

Type integer · GET query or POST JSON · Default 0

Results per page depend on Brave. Organic positions start at 1 within each page.
Minimum: 0
Maximum: 9

spellcheck

SpellcheckOptional

Allow Brave to correct the query spelling.

Type boolean · GET query or POST JSON · Default true

Accepted valuestruefalse

Localization and filters

country

CountryOptional

Two-letter country preference, or all for all regions. Brave determines regional availability.

Type string · GET query or POST JSON · Default us

Pattern: ^(?:[a-z]{2}|all)$

ui_lang

Ui LangOptional

Interface language preference such as en-us or de-de. This does not restrict result languages.

Type string · GET query or POST JSON · Default en-us

Pattern: ^[a-z]{2}(?:-[a-z]{2})?$

safesearch

SafesearchOptional

Adult-content filtering preference.

Type string · GET query or POST JSON · Default moderate

Accepted valuesoffmoderatestrict

tf

TfOptional

Optional date window: pd for past day, pw for past week, pm for past month, py for past year.

Type string · GET query or POST JSON

Accepted valuespdpwpmpy

// response

Work with the complete JSON response

Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.

Response groups include search_metadata, search_parameters, organic_results, search_information, pagination, litescrape_pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.

Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.

Illustrative success response. Result groups and optional fields depend on upstream content.

{
  "search_metadata": {
    "id": "brave-example",
    "status": "Success",
    "created_at": "2026-10-09T00:00:00+00:00",
    "processed_at": "2026-10-09T00:00:00+00:00",
    "total_time_taken": 0.5,
    "brave_url": "https://search.brave.com/search?q=python+programming",
    "json_endpoint": "https://api.litescrape.com/api/brave/search?q=python+programming"
  },
  "search_parameters": {
    "q": "python programming",
    "offset": 0,
    "country": "us",
    "ui_lang": "en-us",
    "safesearch": "moderate",
    "tf": null,
    "spellcheck": true
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Welcome to Python.org",
      "link": "https://www.python.org/",
      "snippet": "Python is a programming language that lets you work quickly and integrate systems more effectively.",
      "displayed_link": "python.org",
      "favicon": "https://imgs.search.brave.com/r3e7IWxGr6QAH681qFfPX5tiFAeshAzaNhO5YwXtDm4/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvNTJjMzZjNDBj/MmIzODgwMGUyOTRj/Y2E5MjM3YjRkYTZj/YWI1Yzk1NTlmYTgw/ZDBjNzM0MGMxZjQz/YWFjNTczYy93d3cu/cHl0aG9uLm9yZy8"
    }
  ],
  "search_information": {
    "organic_results_state": "Results found"
  },
  "pagination": {
    "current": 0,
    "next": "https://search.brave.com/search?q=python+programming&offset=1"
  },
  "litescrape_pagination": {
    "current": 0,
    "next": "https://api.litescrape.com/api/brave/search?q=python+programming&offset=1"
  },
  "submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}

Litescrape sells to AI agents - live prices and self-serve payment

Brave Search API

Integrate Brave Search

JSON POST request example

Brave Search parameters

Search query

Localization and filters

Work with the complete JSON response

More Brave APIs