Brave Search API

The Brave Search API returns structured results from Brave Search — organic results with sitelinks, FAQs, forum discussions, videos, places and related searches. Supports country and language localization, freshness and safe-search filters, and pagination. Each successful request costs 5 API credits.

Endpoint: https://api.scrapingdog.com/brave/search

API Parameters

🔑

Scrapingdog Parameters

api_key Required
Your personal API key. Available on your dashboard.

Type: String

🔍

Search Query

query Required
The search query to look up on Brave Search (e.g., india, coffee shops near me). Either query or url must be passed.

Type: String
url Optional
Alternative to query — pass a full Brave Search URL directly.

Type: String

🌍

Localization

country Optional
Two-letter country code for the search region (e.g., us, in, gb).

Type: String
lang Optional
Language code for the search results (e.g., en, es, fr).

Type: String

⚙

️ Filters & Options

count Optional
Number of results to return.

Type: Integer
offset Optional
Pagination offset used to fetch subsequent pages of results.

Type: Integer
safesearch Optional
Adult content filtering level. Accepted values: off, moderate, strict.

Type: String
freshness Optional
Filter results by how recently they were indexed. Accepted values: pd (past day), pw (past week), pm (past month), py (past year), or a custom range in the format YYYY-MM-DDtoYYYY-MM-DD.

Type: String
goggles Optional
Apply a Brave Goggle (custom re-ranking definition) to the search results.

Type: String
result_filter Optional
Comma-separated list of result types to include in the response (e.g., web,news,videos).

Type: String
spellcheck Optional
Set to false to disable Brave's automatic spellchecking of the query. Default: true.

Type: Boolean

API Examples

Code to Integrate

curl "https://api.scrapingdog.com/brave/search?api_key=APIKEY&query=india&country=us&lang=en"

import requests

api_key = "APIKEY"
url = "https://api.scrapingdog.com/brave/search"

params = {
    "api_key": api_key,
    "query": "india",
    "country": "us",
    "lang": "en",
    "safesearch": "off",
    "freshness": "pd"
}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

const axios = require('axios');

axios.get('https://api.scrapingdog.com/brave/search', {
  params: {
    api_key: 'APIKEY',
    query: 'india',
    country: 'us',
    lang: 'en'
  }
}).then(response => console.log(response.data))
  .catch(error => console.error(error.message));

<?php
$url = 'https://api.scrapingdog.com/brave/search?' . http_build_query([
    'api_key' => 'APIKEY',
    'query'   => 'india',
    'country' => 'us',
    'lang'    => 'en',
]);
echo file_get_contents($url);

require 'net/http'
require 'uri'

url = URI.parse("https://api.scrapingdog.com/brave/search")
url.query = URI.encode_www_form(
  'api_key' => 'APIKEY',
  'query' => 'india',
  'country' => 'us',
  'lang' => 'en'
)

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
puts http.request(Net::HTTP::Get.new(url)).body

import java.io.*;
import java.net.*;

public class Main {
    public static void main(String[] args) throws Exception {
        String apiUrl = "https://api.scrapingdog.com/brave/search?api_key=APIKEY&query=india&country=us&lang=en";
        URL url = new URL(apiUrl);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
        String line;
        while ((line = reader.readLine()) != null) System.out.println(line);
        conn.disconnect();
    }
}

API Response

{
  "organic_results": [
    {
      "position": 1,
      "title": "India - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/India",
      "displayed_link": "en.wikipedia.org › wiki › India",
      "source": "Wikipedia",
      "date": "2 hours ago",
      "snippet": "India, officially the Republic of India, is a country in South Asia. It is the world's seventh-largest country by area and the largest by population...",
      "sitelinks": [
        { "title": "Etymology", "link": "https://en.wikipedia.org/wiki/India#Etymology" },
        { "title": "History", "link": "https://en.wikipedia.org/wiki/India#History" },
        { "title": "Geography", "link": "https://en.wikipedia.org/wiki/India#Geography" }
      ]
    },
    {
      "position": 2,
      "title": "India | History, Maps, Population, Economy, & Facts | Britannica",
      "link": "https://www.britannica.com/place/India",
      "displayed_link": "britannica.com › geography & travel › countries of the world",
      "source": "Encyclopedia Britannica",
      "date": "20 hours ago",
      "snippet": "India is a country that occupies the greater part of South Asia. It is a constitutional republic that represents a highly diverse population consisting of thousands of ethnic groups."
    }
  ],
  "faq": [
    {
      "question": "How many people live in India?",
      "answer": "As of 2025 India's population is estimated to be about 1,398,885,000.",
      "source_link": "https://www.britannica.com/place/India",
      "source": "britannica.com"
    }
  ],
  "discussions": [
    {
      "title": "what is going on with the student protests in india?",
      "snippet": "Friendly reminder that all top level comments must: start with \"Answer: \"...",
      "link": "https://www.reddit.com/r/OutOfTheLoop/comments/1v4h1ll/what_is_going_on_with_the_student_protests_in/",
      "forum": "r/OutOfTheLoop",
      "comments": "80",
      "upvotes": "731",
      "date": "July 23, 2026"
    }
  ],
  "videos_results": [
    {
      "title": "China's Xi likely to visit India with big delegation for first ...",
      "link": "https://www.reuters.com/world/china/chinas-xi-likely-visit-india-with-big-delegation-first-time-seven-years-2026-08-24/",
      "source": "reuters.com",
      "thumbnail": "https://imgs.search.brave.com/5WeuAXYMj4NBSywJaVl3SJHkKv1-OyLJQ3UJDzJaFpM/rs:fit:200:200:1:0/g:ce/...",
      "date": "8 hours ago"
    }
  ],
  "places_results": [
    { "name": "Taj Mahal", "category": "Monument", "image": "https://imgs.search.brave.com/Nym_00lSbASL7r5dwp-VebPCvOaWz7MP6iK15-W0HGU/rs:fit:500:0:0:0/g:ce/...", "rating": 5 }
  ],
  "related_searches": [
    { "query": "india cricket", "link": "https://search.brave.com/search?q=india%20cricket&source=relatedQueries" },
    { "query": "india flag", "link": "https://search.brave.com/search?q=india%20flag&source=relatedQueries" },
    { "query": "india states", "link": "https://search.brave.com/search?q=india%20states&source=relatedQueries" }
  ]
}