---
title: "Search Brave"
method: GET
path: "/brave/search"
tags: ["Brave"]
---

# Search Brave

`GET /brave/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/brave/search`
- Auth: API key in header `x-api-key`

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

## Query parameters

- `q` string, required
- `offset` integer
- `country` 'all' | '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' | 'za'
- `lang` 'de-de' | 'en-ca' | 'en-gb' | 'en-in' | 'en-us' | 'fi-fi' | 'fr-ca' | 'fr-fr' | 'ja-jp' | 'pt-br' | 'sq-al' | 'sw-ke' | 'zh-tw'
- `time_range` 'any' | 'day' | 'week' | 'month' | 'year' | 'custom'
- `date_from` string
- `date_to` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- BraveSearchResponseDoc
  - `code` integer
  - `data` BraveSearchResponse
    - `discussions` BraveDiscussion[]: Forum and Q&A discussions Brave shows for the query. Omitted when there are none.
      - `age` string: When the thread was posted, as Brave shows it.
      - `comment_count` integer: Number of replies Brave shows for the thread. Omitted when Brave shows none.
      - `description` string: Short excerpt of the thread as Brave shows it.
      - `favicon` string: URL of the site's favicon as Brave serves it.
      - `forum` string: Forum or subreddit the thread belongs to, for example `r/pythontips`.
      - `hostname` string: Host name of the site hosting the thread.
      - `path` string: Breadcrumb-style path of the thread URL as Brave shows it.
      - `position` integer: Rank of the discussion in the discussions block, starting at 1.
      - `score` integer: Vote score of the thread. Omitted when Brave shows none.
      - `title` string: Title of the forum thread or question.
      - `top_comment` string: Text of the top comment Brave shows for the thread.
      - `url` string: URL of the discussion thread.
    - `knowledge_card` BraveKnowledgeCard
      - `category` string: Kind of entity the card describes, for example `computer program`.
      - `description` string: One-line description of the entity.
      - `image` string: URL of the card's image.
      - `long_description` string: Longer description of the entity.
      - `provider` BraveKnowledgeCardProvider
        - `icon` string: URL of the provider's icon.
        - `name` string: Name of the provider, for example `Wikipedia`.
        - `url` string: URL of the provider's page for the entity.
      - `title` string: Name of the entity or topic the card is about.
      - `url` string: URL of the source page the card draws on.
    - `pagination` BraveSearchPagination
      - `next_offset` integer: Offset to request the next page. Omitted when there is no next page.
      - `offset` integer: Zero-based page offset of this response.
      - `previous_offset` integer: Offset to request the previous page. Omitted on the first page.
    - `related_queries` string[]: Related searches Brave suggests for the query.
    - `results` BraveSearchResult[]: Organic web results in Brave's order.
      - `age` string: How old the page is, as Brave shows it. Omitted when Brave shows none.
      - `description` string: Result snippet as shown on the Brave results page.
      - `favicon` string: URL of the site's favicon as Brave serves it.
      - `hostname` string: Host name of the result URL.
      - `path` string: Breadcrumb-style path of the result URL as Brave shows it.
      - `position` integer: Rank of the result on the page, starting at 1.
      - `title` string: Result title as shown on the Brave results page.
      - `url` string: URL of the result page.
    - `videos` BraveVideoResult[]: Video results Brave shows for the query. Omitted when there are none.
      - `age` string: When the video was published, as Brave shows it.
      - `creator` string: Channel or creator that published the video.
      - `description` string: Video description snippet as Brave shows it.
      - `duration` string: Video length as Brave shows it, for example `08:47`.
      - `favicon` string: URL of the hosting site's favicon as Brave serves it.
      - `hostname` string: Host name of the video URL.
      - `path` string: Path of the video URL as Brave shows it.
      - `platform` string: Platform hosting the video, for example `YouTube`.
      - `position` integer: Rank of the video among the results, starting at 1; continues across pages in video searches.
      - `thumbnail` string: URL of the video thumbnail.
      - `title` string: Video title as shown on the Brave results page.
      - `url` string: URL of the video page.
      - `views` string: View count as Brave shows it.
  - `msg` string

## Other responses

- `400`: Missing or invalid query
- `404`: No results found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)