Brave

Search Brave

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.

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

Query parameters

qstring required

Search query

offsetinteger

Zero-based Brave result page

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'

Brave result country; defaults to us

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'

Brave UI language; defaults to en-us

time_range'any' | 'day' | 'week' | 'month' | 'year' | 'custom'

Preset time filter: any, day, week, month, year, or custom

date_fromstring

Custom start date in YYYY-MM-DD; requires date_to

date_tostring

Custom end date in YYYY-MM-DD; requires date_from

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "discussions": [
      {
        "age": "October 24, 2024",
        "comment_count": 30,
        "description": "I have free time from highschool and want to get into coding, and tips on diving in and learning.",
        "favicon": "https://imgs.search.brave.com/example-reddit.ico",
        "forum": "r/pythontips",
        "hostname": "www.reddit.com",
        "path": "r > pythontips > comments > 1gav6bm > how_to_learn_python",
        "position": 1,
        "score": 25,
        "title": "How to learn python",
        "top_comment": "r/learnpython",
        "url": "https://www.reddit.com/r/pythontips/comments/1gav6bm/how_to_learn_python/"
      }
    ],
    "knowledge_card": {
      "category": "computer program",
      "description": "computer program that produces the message \"Hello, world!\", often used to illustrate the basic syntax of a programming language",
      "image": "https://imgs.search.brave.com/example-card.png",
      "long_description": "A \"Hello, World!\" program is usually a simple computer program that displays on the screen a message similar to \"Hello, World!\".",
      "provider": {
        "icon": "https://imgs.search.brave.com/example-provider.ico",
        "name": "Wikipedia",
        "url": "https://en.wikipedia.org/wiki/%22Hello,_World!%22_program"
      },
      "title": "\"Hello, World!\" program",
      "url": "https://en.wikipedia.org/wiki/%22Hello,_World!%22_program"
    },
    "pagination": {
      "next_offset": 1
    },
    "related_queries": [
      "hello world anime",
      "hello world code"
    ],
    "results": [
      {
        "age": "1 day ago",
        "description": "OpenAI helps you build and deploy AI systems.",
        "favicon": "https://imgs.search.brave.com/example.ico",
        "hostname": "openai.com",
        "path": "research > index",
        "position": 1,
        "title": "OpenAI",
        "url": "https://openai.com/"
      }
    ],
    "videos": [
      {
        "age": "March 24, 2024",
        "creator": "Train To Code",
        "description": "Introducing you to 15 of the most popular programming languages in the world, by writing hello world to the console.",
        "duration": "08:47",
        "favicon": "https://imgs.search.brave.com/example-youtube.ico",
        "hostname": "www.youtube.com",
        "path": "watch",
        "platform": "YouTube",
        "position": 1,
        "thumbnail": "https://imgs.search.brave.com/example-thumb.jpg",
        "title": "Hello World in 15 Programming Languages - YouTube",
        "url": "https://www.youtube.com/watch?v=tRUsXTbixIE",
        "views": "118"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.