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 Google and Bing 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 | - |
| country | string | No | Brave result country; defaults to us | - |
| lang | string | No | Brave UI language; defaults to en-us | - |
| offset | integer | No | Zero-based Brave result page | - |
| 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 | - |
| date_to | string | No | Custom end date in YYYY-MM-DD; requires date_from | - |
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 normalized 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 normalized Brave news search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search news HTML and return 503 when Brave serves a challenge page or unusable HTML.
Response notes
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI announces update", "url": "https://example.com/openai-news", "description": "OpenAI announced an update.", "source": "Example News", "hostname": "example.com", "thumbnail": "https://imgs.search.brave.com/example-thumb.jpg", "age": "2 hours ago" } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
MCP tool brave_news
/brave/videosReturns normalized Brave video search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search video HTML and return 503 when Brave serves a challenge page or unusable HTML.
Response notes
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI DevDay keynote - YouTube", "url": "https://www.youtube.com/watch?v=openai-devday", "description": "Watch the OpenAI DevDay keynote.", "platform": "YouTube", "creator": "OpenAI", "thumbnail": "https://imgs.search.brave.com/example-thumb.jpg", "duration": "45:12", "age": "November 6, 2023" } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
MCP tool brave_videos
/brave/imagesReturns normalized Brave image search results for a query string. Locale defaults to country=us and lang=en-us. Results are fetched from public Brave Search image HTML and return 503 when Brave serves a challenge page or unusable HTML.
Response notes
- Challenge pages, bot blocks, malformed Brave bootstrap data, and parser drift return `503`. - Empty first-page parser output is only treated as no results when Brave includes an explicit no-results marker. Example response: ```json { "code": 200, "msg": "OK", "data": { "results": [ { "position": 1, "title": "OpenAI colors mobile 08", "url": "https://area17.com/clients/openai", "source": "area17.com", "image_url": "https://media-cdn-prod.area17.com/openai.jpg", "thumbnail": "https://imgs.search.brave.com/example", "width": 1000, "height": 1184 } ], "pagination": { "offset": 0, "next_offset": 1 } } } ```
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.
Response notes
- Malformed suggest payloads and upstream blocks return `503`. - Duplicate or empty suggestions are removed from the normalized response. Example response: ```json { "code": 200, "msg": "OK", "data": { "query": "openai", "suggestions": [ { "position": 1, "query": "openai api" } ] } } ```
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.
OpenPair Brave results with Google Search monitoring.
OpenAdd search-demand and trend discovery signals to Brave search monitoring.
OpenTrack keyword rankings, result changes, and search visibility.
OpenStore recurring SERP checks for keyword, URL, and competitor monitoring.
OpenBuild keyword tracking dashboards with Brave Search as an alternative engine signal.
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 /google/search and /bing/search endpoints shows how much of a ranking is Google-specific. Same key, same response shape.
FAQ
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 Google and Bing 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 Google, Bing, and Brave.
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 Google and Bing 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 Google, Bing and DuckDuckGo 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.