Crawlora
Console

Brave API endpoint

Search Brave

Returns 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.

GETapiKey3 credits/requestbrave.searchResponseDoc/brave/search

Parameters

NameInTypeRequiredEnumExampleDescription
qquerystringYesopenaiSearch query
offsetqueryintegerNo1Zero-based Brave result page
countryquerystringNoall, ar, at, au, be, br, ca, ch, cl, cn, de, dk, es, fi, fr, gb, gr, hk, id, in, it, jp, kr, mx, my, nl, no, nz, ph, pl, pt, ru, sa, se, sg, tr, tw, us, zausBrave result country; defaults to us
langquerystringNode-de, en-ca, en-gb, en-in, en-us, fi-fi, fr-ca, fr-fr, ja-jp, pt-br, sq-al, sw-ke, zh-twen-usBrave UI language; defaults to en-us
time_rangequerystringNoany, day, week, month, year, customPreset time filter: any, day, week, month, year, or custom
date_fromquerystringNo2026-03-01Custom start date in YYYY-MM-DD; requires date_to
date_toquerystringNo2026-03-30Custom end date in YYYY-MM-DD; requires date_from
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
3 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Failure responses

StatusDescriptionSchema
400Missing or invalid query#/definitions/app.Response
404No results found#/definitions/app.Response
429Rate limit exceeded#/definitions/app.Response
500Internal server error#/definitions/app.Response

Example response

{
  "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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/brave.searchResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNo200
databrave.SearchResponseNo
data.discussionsarrayNo
data.discussions[].agestringNoOctober 24, 2024
data.discussions[].comment_countintegerNo30
data.discussions[].descriptionstringNoI have free time from highschool and want to get into coding, and tips on diving in and learning.
data.discussions[].faviconstringNohttps://imgs.search.brave.com/example-reddit.ico
data.discussions[].forumstringNor/pythontips
data.discussions[].hostnamestringNowww.reddit.com
data.discussions[].pathstringNor > pythontips > comments > 1gav6bm > how_to_learn_python
data.discussions[].positionintegerNo1
data.discussions[].scoreintegerNo25
data.discussions[].titlestringNoHow to learn python
data.discussions[].top_commentstringNor/learnpython
data.discussions[].urlstringNohttps://www.reddit.com/r/pythontips/comments/1gav6bm/how_to_learn_python/
data.knowledge_cardbrave.KnowledgeCardNo
data.knowledge_card.categorystringNocomputer program
data.knowledge_card.descriptionstringNocomputer program that produces the message "Hello, world!", often used to illustrate the basic syntax of a programming language
data.knowledge_card.imagestringNohttps://imgs.search.brave.com/example-card.png
data.knowledge_card.long_descriptionstringNoA "Hello, World!" program is usually a simple computer program that displays on the screen a message similar to "Hello, World!".
data.knowledge_card.providerbrave.KnowledgeCardProviderNo
data.knowledge_card.provider.iconstringNohttps://imgs.search.brave.com/example-provider.ico
data.knowledge_card.provider.namestringNoWikipedia
data.knowledge_card.provider.urlstringNohttps://en.wikipedia.org/wiki/%22Hello,_World!%22_program
data.knowledge_card.titlestringNo"Hello, World!" program
data.knowledge_card.urlstringNohttps://en.wikipedia.org/wiki/%22Hello,_World!%22_program
data.paginationbrave.SearchPaginationNo
data.pagination.next_offsetintegerNo1
data.pagination.offsetintegerNo0
data.pagination.previous_offsetintegerNo0
data.related_queriesarrayNohello world anime,hello world code
data.resultsarrayNo
data.results[].agestringNo1 day ago
data.results[].descriptionstringNoOpenAI helps you build and deploy AI systems.
data.results[].faviconstringNohttps://imgs.search.brave.com/example.ico
data.results[].hostnamestringNoopenai.com
data.results[].pathstringNoresearch > index
data.results[].positionintegerNo1
data.results[].titlestringNoOpenAI
data.results[].urlstringNohttps://openai.com/
data.videosarrayNo
data.videos[].agestringNoMarch 24, 2024
data.videos[].creatorstringNoTrain To Code
data.videos[].descriptionstringNoIntroducing you to 15 of the most popular programming languages in the world, by writing hello world to the console.
data.videos[].durationstringNo08:47
data.videos[].faviconstringNohttps://imgs.search.brave.com/example-youtube.ico
data.videos[].hostnamestringNowww.youtube.com
data.videos[].pathstringNowatch
data.videos[].platformstringNoYouTube
data.videos[].positionintegerNo1
data.videos[].thumbnailstringNohttps://imgs.search.brave.com/example-thumb.jpg
data.videos[].titlestringNoHello World in 15 Programming Languages - YouTube
data.videos[].urlstringNohttps://www.youtube.com/watch?v=tRUsXTbixIE
data.videos[].viewsstringNo118
msgstringNoOK

Example request

curl -X GET "https://api.crawlora.net/api/v1/brave/search?q=openai&offset=1&country=us&lang=en-us&date_from=2026-03-01&date_to=2026-03-30" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/brave/search");
url.searchParams.set("q", "openai");
url.searchParams.set("offset", "1");
url.searchParams.set("country", "us");
url.searchParams.set("lang", "en-us");
url.searchParams.set("date_from", "2026-03-01");
url.searchParams.set("date_to", "2026-03-30");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();
Open in PlaygroundBack to group