Collect Brave Search web results, related queries, discussions, videos, news, image results, and knowledge-card data as structured JSON for alternative search monitoring, rank checks, and agent-native workflows.
Structured output
Use Crawlora's Brave Search API to enrich search monitoring, brand tracking, and agent-native workflows with structured results from supported public Brave Search pages. Crawlora normalizes response fields and exposes endpoint-specific docs, Playground examples, and documented error behavior.
SERP workflows
Brave Search can surface different domains, discussions, videos, and context modules than other engines. Crawlora helps teams run Brave rank checks alongside Bing and DuckDuckGo monitoring without maintaining separate scraping infrastructure.
SERP monitoring workflowsRequest schema
These parameters come from the active Search Brave catalog entry.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| q | string | Yes | Search query | openai |
| country | string | No | Brave result country; defaults to us | us |
| lang | string | No | Brave UI language; defaults to en-us | en-us |
| offset | integer | No | Zero-based Brave result page | 1 |
| time_range | string | No | Preset time filter: any, day, week, month, year, or custom | - |
| date_from | string | No | Custom start date in YYYY-MM-DD; requires date_to | 2026-03-01 |
| date_to | string | No | Custom end date in YYYY-MM-DD; requires date_from | 2026-03-30 |
Example JSON
This example is rendered from the active endpoint catalog so the page stays aligned with Docs and Playground.
{
"code": 200,
"msg": "OK",
"data": {
"results": [
{
"position": 1,
"title": "OpenAI",
"url": "https://openai.com/",
"description": "OpenAI helps you build and deploy AI systems.",
"hostname": "openai.com",
"path": "research > overview"
}
],
"pagination": {
"offset": 0,
"next_offset": 1
},
"related_queries": [
"openai api"
],
"knowledge_card": {
"title": "OpenAI",
"description": "AI research and deployment company",
"long_description": "OpenAI is an AI research and deployment company building useful models and tools.",
"url": "https://openai.com/",
"image": "https://imgs.search.brave.com/openai-card.png",
"category": "Artificial intelligence company"
},
"discussions": [
{
"position": 1,
"title": "Why is OpenAI so popular?",
"url": "https://www.reddit.com/r/OpenAI/comments/abc123/why_is_openai_so_popular/",
"description": "Trying to understand why OpenAI has such a large audience.",
"forum": "r/OpenAI",
"hostname": "www.reddit.com"
}
],
"videos": [
{
"position": 1,
"title": "OpenAI DevDay keynote - YouTube",
"url": "https://www.youtube.com/watch?v=openai-devday",
"description": "Watch the OpenAI DevDay keynote and product announcements.",
"platform": "YouTube",
"creator": "OpenAI"
}
]
}
}Endpoint catalog
/brave/searchReturns web search results from Brave Search for a query string, along with offset-based pagination, related queries, discussions, videos, and the right-side knowledge card when Brave includes one. Use time_range for preset ranges or date_from/date_to for a custom YYYY-MM-DD range. Locale defaults to country=us and lang=en-us.
MCP tool brave_search
/brave/newsReturns Brave news search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Brave serves a challenge page or unusable results.
Response notes
- Challenge pages, bot blocks, and unusable upstream responses return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker.
MCP tool brave_news
/brave/videosReturns Brave video search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Brave serves a challenge page or unusable results.
Response notes
- Challenge pages, bot blocks, and unusable upstream responses return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker.
MCP tool brave_videos
/brave/imagesReturns Brave image search results for a query string. Locale defaults to country=us and lang=en-us. Returns 503 when Brave serves a challenge page or unusable results.
Response notes
- Challenge pages, bot blocks, and unusable upstream responses return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker.
MCP tool brave_images
/brave/suggestReturns Brave autosuggest query completions for a query prefix. Locale defaults to country=us and lang=en-us. Suggestions are fetched from public Brave Search suggest JSON and trimmed to the requested count. `rich=true` adds entity metadata (name, description, category, image) where Brave resolves a suggestion to a known entity.
Response notes
- Malformed suggest payloads and upstream blocks return `503`. - Duplicate or empty suggestions are removed from the response. - `entity` is omitted for plain phrase suggestions and for every row when `rich` is not `true`.
MCP tool brave_suggest
Managed execution
Crawlora turns supported public Brave Search result pages into normalized JSON with endpoint-specific request logic, docs, Playground examples, and structured error responses.
Endpoint-specific request logic for Brave web, news, video, image, and suggest pages
Proxy-aware collection and challenge-aware behavior where supported
Normalized JSON for organic results, related queries, discussions, videos, and knowledge cards
Docs and Playground examples generated from the active catalog
Structured error responses for unsupported or unusable upstream responses
Credit-based usage tied to documented endpoint costs
Crawlora is not the official Brave Search API. Crawlora provides structured public web data extraction endpoints for supported Brave Search result pages. If your use case requires Brave's official licensed search index API, use Brave's official API. Crawlora is useful when you need Crawlora's cross-platform scraping API, docs, playground, response normalization, and managed execution workflow across multiple public web sources.
Related APIs
Connect this endpoint with adjacent Crawlora search, monitoring, docs, and pricing pages.
Compare Brave visibility with Bing SERP data.
OpenAdd search-demand and trend discovery signals to Brave search monitoring.
OpenTrack keyword rankings, result changes, and search visibility.
OpenCheck keyword positions and ranking URLs with structured result snapshots.
OpenUse Crawlora as the data layer behind agency and SaaS SEO reports.
OpenReview plans, credits, limits, and usage options.
OpenBrowse the full active endpoint catalog.
OpenHow to scrape Brave
Crawlora's Brave endpoints are GETs that take q with offset, count, country and lang: /brave/search returns web results with offset-based pagination, related queries, discussions, videos and the right-side knowledge card when Brave includes one; /brave/news, /brave/videos and /brave/images return the verticals with time_range and date filters where Brave supports them; /brave/suggest returns autosuggest completions. Locale defaults to country=us and lang=en-us, and a Brave challenge page returns a documented 503.
GET /brave/search?q=<keyword>&country=us&lang=en-us. Rows carry position, title, URL and snippet; the response also includes related queries, discussions, videos and the knowledge card when present.
Brave paginates by offset rather than page number: pass offset=<n> to continue from the nth result. Store the offset with each row so runs are comparable.
GET /brave/news and /brave/videos accept time_range and date_from (and date_to on web search) to limit results to a window, which suits monitoring rather than one-off lookups. GET /brave/images returns image results; /brave/suggest returns completions.
Brave runs its own index, so comparing /brave/search against Crawlora's /bing/search and /duckduckgo/search endpoints shows how much a ranking shifts between independently built indexes. Same key, same response shape.
On 2026-10-30 /brave/search for openai with count=10 returned 20 web results plus 10 related queries, a knowledge card and 5 videos, while images and news each returned 40 at count=40. Pagination uses an offset and next_offset.
Client libraries
Install the dedicated Brave Search client for your language. Each package covers the Brave Search endpoints on this page and calls Crawlora's hosted API with your API key.
npm install @crawlora-org/bravenpmpip install crawlora-bravePyPIgo get github.com/Crawlora-org/crawlora-bravepkg.go.devgem install crawlora-braveRubyGemsnet.crawlora:crawlora-braveMaven Centralcomposer require crawlora/bravePackagistcargo add crawlora-bravecrates.ioAgent skills
Install a Crawlora agent skill and your agent can pull Brave data as JSON through the documented API, without writing a scraper. These skills cover Brave:
Validate broad topic, problem, audience, or content demand by comparing autocomplete, Google Trends, search results, and sampled discussion. For a…
npx skills add github.com/Crawlora-org/crawlora-skills --skill topic-demand-validationRuns SERP and keyword research via Crawlora — Google, Bing, Brave, DuckDuckGo, Yahoo, Baidu, Yandex, selected Qwant/Startpage suggestions, and…
npx skills add github.com/Crawlora-org/crawlora-skills --skill serp-keyword-researchFAQ
Answers for developers evaluating Crawlora for supported public search result pages.
Yes. Crawlora provides a Brave Search endpoint for supported public Brave Search result pages and returns normalized JSON through documented API routes.
No. Crawlora is not the official Brave Search API. Crawlora provides structured public web data extraction endpoints for supported Brave Search result pages. If your use case requires Brave's official licensed search index API, use Brave's official API.
Brave removed its free Brave Search API tier in February 2026 and moved developers to metered billing (roughly $5 per 1,000 requests, with attribution required for the small monthly credit). Brave's official API still exists, but Crawlora's Brave Search endpoint is an alternative that returns Brave results as normalized JSON under Crawlora's credit-based pricing — convenient if you already call Crawlora for Bing and DuckDuckGo search and want one API across engines.
Brave's official API uses its own key from the Brave Search API dashboard. With Crawlora you instead use a single Crawlora API key (sent as the x-api-key header) to call the Brave endpoint — the same key works across Bing, Brave, and DuckDuckGo.
The catalog example includes organic results with positions, titles, URLs, descriptions, hostnames, pagination, related queries, knowledge-card data, discussions, and videos when Brave includes them.
Yes. Brave Search data can support SERP monitoring and search enrichment workflows, especially when you compare Brave visibility alongside Bing and DuckDuckGo results.
Yes. The Brave platform includes search, news, videos, images, and suggest endpoints where they are active in the generated catalog.
Crawlora surfaces documented errors for unusable upstream responses. Brave media endpoint docs list challenge pages, blocks, malformed bootstrap data, and parser drift as 503 conditions where supported.
Brave can expose different ranking patterns, discussions, source diversity, and knowledge-card context, which makes it useful as an additional search visibility signal.
Brave does not publish a Google Search Console-style console for third parties, but you can build your own Brave search dashboard with Crawlora: pull structured Brave Search results on a schedule and store positions, URLs, and snippets to monitor how your domain and competitors rank on Brave over time. See the SERP monitoring use case for a reference workflow.
GET Crawlora's /brave/search endpoint with q and optional offset, country, lang, time_range, date_from and date_to. You get web results with positions, related queries, discussions, videos and the knowledge card as JSON.
By offset, not page number. Pass offset to continue from a given result index; the response reports the offset it used so you can chain calls.
Brave sells an official Search API with its own plans and quotas. Crawlora's endpoints read the public results pages and return them in the same shape as its Bing, DuckDuckGo and Yahoo endpoints, which matters if you want one integration across engines rather than one vendor per engine.
Yes. Crawlora's /brave/news endpoint accepts time_range and date_from, and /brave/search accepts date_from and date_to, so you can restrict results to a window.
Guides
Read Crawlora guides and comparisons that use the Brave API.
Test /brave/search in Playground, inspect the current response schema in Docs, and compare credit-based usage on the pricing page.