Brave Search API | Web, Image & Video Results

From Clearpath, creators of Google AI Overview, SpyFu Intelligence and Google Ads Transparency. Search results, competitor research and advertising data from the same team.

Why choose this actor?

• Get more than a list of links. Export up to 200 web results alongside available news, discussions, knowledge panels and FAQ answers. Discussion records can include the forum, score and top comment; news records include the publisher and headline.
• Find business contacts in the same search. Local results can include phone numbers, full addresses, ratings, opening hours and coordinates. Search by business type and city to find useful contact details alongside the web results.
• Add images and videos without changing tools. Enable both options to collect image URLs and dimensions, plus video creators, durations and view counts where available. Filter your search by country and recency, then export JSON, CSV or Excel.

Try a search with all result types enabled

{
  "query": "coffee shops in Berlin",
  "maxResults": 5,
  "country": "de",
  "includeExtras": true,
  "includeLocations": true,
  "includeImages": true,
  "includeVideos": true
}

Open actor input and replace the query with your topic or city. This example requests five web results plus available extra sections, images and videos. Increase maxResults to 200 for broader web coverage. Result types and counts depend on what Brave returns.

Free Apify accounts get five lifetime runs, capped at 20 total records per run. Full exports require a paying Apify account. Web results carry the main result charge; every exported record also carries a small dataset-item charge. See pricing below.

Clearpath · Search & Advertising Intelligence
Brave Search You are here	AI Overview Answers & citations	SpyFu Keywords & ad history	Google Ads Creatives & advertisers

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

clearpath/brave-search-api on Apify. Call: ApifyClient("TOKEN").actor("clearpath/brave-search-api").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: query (string, required), maxResults (integer, default 100), country (string, default "us"). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~brave-search-api/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Get token: https://console.apify.com/account/integrations

Quick Start

Basic web search

{
    "query": "best restaurants in Berlin"
}

With image and video results

{
    "query": "golden gate bridge",
    "includeImages": true,
    "includeVideos": true
}

German results from the past week

{
    "query": "Nachrichten",
    "country": "de",
    "timeFilter": "pw",
    "maxResults": 50
}

Input Parameters

Parameter	Type	Description	Default
query	string	Search term. Works exactly like the Brave Search box.	required
includeImages	boolean	Fetch image results alongside web results. Up to 200 images per query.	false
includeVideos	boolean	Fetch video results alongside web results. Up to ~60 videos per query.	false
maxResults	integer	Max web results to return (1-200). Web results carry the main charge; all exported records also carry a dataset-item charge.	100
country	string	2-letter country code. Controls both result region and language. 39 country settings.	us
timeFilter	string	Filter by recency: past day, week, month, or year.	Any time
safesearch	string	Content safety filter: off, moderate, or strict.	off

Output

Each result includes a type field so you can filter by result type in your pipeline. Web results are paginated up to maxResults. All other sections (discussions, news, locations, etc.) are extracted automatically from the first page of results.

Result types

Type	Description	Key fields
web	Standard search links	title, url, description, age, page_age, language, subtype, hostname, favicon, thumbnail
discussion	Reddit, GitHub, forum posts	title, url, description, forum_name, score, top_comment, hostname
infobox	Knowledge panel / Q&A sidebar	title, url, question, answer_text, answer_author, answer_upvotes, suggested_answers, attributes, providers
video_cluster	Inline videos from web search	title, url, duration, views, creator, publisher, thumbnail
news	News cluster	title, url, description, age, source_name, source_logo, thumbnail
faq	FAQ schema results	title, url, question, answer, hostname
rich	Weather, calculator, stock, currency, etc.	rich_type, data (full structured data), provider
location	Local businesses with contact data	title, url, address, phone, rating, reviews_count, price_range, categories, coordinates, opening_hours, thumbnail
image	Dedicated image results (toggle)	title, url, image_url, width, height, source, thumbnail
video	Dedicated video results (toggle)	title, url, duration, views, creator, publisher, thumbnail
search_metadata	Query context	original_query, country, city, coordinates, related_queries

Output example

Query: "best coffee shops in berlin" — 340 results (5 web, 9 discussions, 100 locations, 200 images, 18 videos, and more)

[
  {
    "type": "web",
    "position": 1,
    "title": "Berlin | Brian's Coffee Spot",
    "url": "https://www.brian-coffee-spot.com/the-coffee-spot-guide-to/europe/berlin/",
    "description": "When talking of speciality coffee in Berlin, you can't avoid The Barn...",
    "age": "August 7, 2022",
    "page_age": "2022-08-07T03:07:47",
    "language": "en",
    "subtype": "generic",
    "hostname": "www.brian-coffee-spot.com",
    "thumbnail": "https://imgs.search.brave.com/..."
  },
  // ... 4 more web results

  {
    "type": "discussion",
    "position": 1,
    "title": "Coffee Shops in Berlin",
    "url": "https://www.reddit.com/r/Coffee/comments/7ahwkw/...",
    "description": "Go to the Barn, they have some great coffee.",
    "forum_name": "r/Coffee",
    "score": "3",
    "top_comment": "Go to the Barn, they have some great coffee."
  },
  // ... 8 more discussions

  {
    "type": "infobox",
    "title": "Best coffee in Berlin",
    "url": "https://www.reddit.com/r/askberliners/comments/...",
    "question": "Best coffee in Berlin",
    "answer_text": "Bonanza is a bit too pretentious for me, but worth checking out. Ben Rahim also has some interesting options.",
    "answer_author": "32452353",
    "answer_upvotes": 5,
    "suggested_answers": [
      { "text": "My favorite is DoubleEye, and if you walk down Goltz- and Akazienstraße there's a bunch more...", "author": "senfengel", "upvotes": 3 }
    ]
  },

  {
    "type": "video_cluster",
    "position": 1,
    "title": "3 of the best cafés for coffee and cake in Berlin",
    "url": "https://www.youtube.com/watch?v=4Hz-8xItLSs",
    "duration": "07:30",
    "views": 595,
    "creator": "Helen Edwards",
    "publisher": "YouTube"
  },
  // ... 5 more inline videos

  {
    "type": "location",
    "position": 1,
    "title": "Rausch Schokoladenhaus",
    "url": "https://rausch.de/schokoladenhaus",
    "address": "Charlottenstraße 60, 10117 Berlin, Germany",
    "phone": "+4930757880",
    "rating": 4.6,
    "reviews_count": 2630,
    "price_range": "$$ - $$$",
    "coordinates": { "lat": 52.512053, "lng": 13.3912058 },
    "opening_hours": {
      "Tuesday": "10:00-20:00",
      "Wednesday": "10:00-20:00",
      "Thursday": "10:00-20:00",
      "Friday": "10:00-20:00",
      "Saturday": "10:00-20:00",
      "Sunday": "12:00-20:00"
    },
    "thumbnail": "https://imgs.search.brave.com/..."
  },
  // ... 99 more locations with contact data

  {
    "type": "image",
    "position": 1,
    "title": "Concierge Coffee is one of The 15 Best Coffee Shops in Berlin.",
    "url": "https://foursquare.com/top-places/berlin/best-coffee-shops",
    "source": "foursquare.com",
    "image_url": "https://fastly.4sqi.net/img/general/699x268/...",
    "width": 699,
    "height": 268,
    "thumbnail": "https://imgs.search.brave.com/..."
  },
  // ... 199 more images

  {
    "type": "video",
    "position": 1,
    "title": "I found the BEST coffee shop in Berlin",
    "url": "https://www.youtube.com/watch?v=xCOplUM1mGY",
    "duration": "08:36",
    "creator": "pourtherecord",
    "publisher": "YouTube",
    "tags": ["coffee shops berlin"]
  },
  // ... 17 more videos

  {
    "type": "search_metadata",
    "original_query": "best coffee shops in berlin",
    "country": "us",
    "is_geolocal": true,
    "related_queries": [
      "best coffee in berlin mitte",
      "specialty coffee berlin",
      "berlin coffee roasters",
      "unusual cafes in berlin",
      "bonanza coffee berlin",
      "the barn berlin"
    ]
  }
]

---

Pricing — Pay Per Event (PPE)

Web results carry the primary search-result charge. Every exported record, including bonus sections, images and videos, also carries a $0.00001 dataset-item charge.

Charge	Price
Web result, Free plan	$0.00299
Web result, Bronze plan	$0.00279
Web result, Silver plan	$0.00249
Web result, Gold / Platinum / Diamond	$0.00229
Exported dataset record, any type	$0.00001

Images, videos, discussions, news and locations have no additional web-result charge. Their dataset-item charge still applies.

---

How Brave Search Results Work

Country controls language

The country parameter is the main lever for result language. Set country to de for German results, fr for French, es for Spanish. No separate language setting needed.

Result counts

Type	Results per query	Notes
Web	~20 per page, up to 200	Automatic pagination based on maxResults
Discussions	Up to ~10	Reddit, GitHub, forums
News	Up to ~8	News cluster from first page
Locations	Up to ~30+	Local businesses with address, phone, rating, hours
Infobox	0-1	Knowledge panel / Q&A sidebar
Video cluster	Up to ~6	Inline videos from web search
FAQ	Up to ~4	FAQ schema answers
Rich	0-1	Weather, calculator, stock, currency widgets
Images (toggle)	Up to 200	Single batch, no pagination
Videos (toggle)	~60 max	2 pages fetched automatically

Time filtering

Use timeFilter to get recent results only. Works with web results. Useful for monitoring news, trending topics, or recent content.

---

API Integration

Python

from apify_client import ApifyClient

client = ApifyClient("your_token")
run = client.actor("clearpath/brave-search-api").call(run_input={
    "query": "machine learning trends 2026",
    "maxResults": 50,
    "includeImages": True
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    if item["type"] == "web":
        print(f'{item["title"]} — {item["url"]}')
    elif item["type"] == "discussion":
        print(f'[{item["forum_name"]}] {item["title"]} (score: {item["score"]})')
    elif item["type"] == "location":
        print(f'{item["title"]} — {item.get("rating", "N/A")} stars')
    elif item["type"] == "news":
        print(f'[{item["source_name"]}] {item["title"]}')

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'your_token' });
const run = await client.actor('clearpath/brave-search-api').call({
    query: 'machine learning trends 2026',
    maxResults: 50,
    includeImages: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const webResults = items.filter(i => i.type === 'web');
const discussions = items.filter(i => i.type === 'discussion');
const news = items.filter(i => i.type === 'news');
const locations = items.filter(i => i.type === 'location');

---

Advanced Usage

Multi-language research

Fetch results in different languages by changing the country code:

{
    "query": "artificial intelligence",
    "country": "jp",
    "maxResults": 30
}

Strict safe search for family-friendly content

{
    "query": "educational games for kids",
    "safesearch": "strict",
    "includeImages": true
}

Recent news monitoring

{
    "query": "startup funding",
    "timeFilter": "pd",
    "maxResults": 50
}

---

Data Export

• JSON — Structured data for programmatic use
• CSV — Spreadsheet-ready format
• Excel — Direct download from Apify Console

---

Use with AI Assistants (OpenClaw, Claude, etc.)

Connect this actor to AI assistants via Apify's MCP server. Ask your assistant to search the web using Brave.

Setup

1. Go to mcp.apify.com and add clearpath/brave-search-api to your MCP server
2. Connect the MCP server to your AI assistant (OpenClaw, Claude Desktop, Cursor, etc.)

OpenClaw example

Add Apify's MCP server to ~/.openclaw/openclaw.json:

{
  "provider": {
    "mcpServers": {
      "apify": {
        "command": "npx",
        "args": ["-y", "@apify/actors-mcp-server"],
        "env": {
          "APIFY_TOKEN": "your-apify-token"
        }
      }
    }
  }
}

Then message your OpenClaw bot on Telegram, WhatsApp, or Discord:

"Search Brave for the latest AI research papers from this week"

"Find images of modern architecture in Tokyo using Brave Search"

"Get me 50 search results about renewable energy trends in Germany"

The assistant calls the Brave Search API, gets structured results, and responds with titles, URLs, and descriptions.

---

Automation

• Scheduled runs — Monitor search trends daily or weekly
• Webhooks — Get notified when new results are ready
• API — Integrate search results into your data pipeline

---

FAQ

Q: How many results can I get per run? A: Up to 200 web results, 200 images, and ~60 videos per query. Every query also returns discussions, news, locations, knowledge panels, and other sections automatically. Web results are controlled by maxResults, images and videos return all available results when toggled on. Web results carry the main charge; all exported records also carry a dataset-item charge.

Q: Does this need a Brave account? A: No. No account, login, or API key required.

Q: How fresh is the data? A: Results are fetched live from Brave Search. Use timeFilter set to "Past day" for the most recent content.

Q: Can I search in languages other than English? A: Yes. Set country to the target country code. For example, de for German, fr for French, es for Spanish. Brave returns results in the corresponding language.

Q: What result types do I get? A: Every query returns web links plus any available discussions, news, locations, knowledge panels, FAQ answers, inline videos, and rich widgets (weather, stocks, etc.). Enable includeImages or includeVideos for dedicated image/video results on top of that. Each result has a type field for easy filtering.

Q: Is there a free tier? A: Yes. Free users get 5 lifetime runs with up to 20 results each. Upgrade for unlimited usage.

Q: How is pricing calculated? A: Web results cost $0.00229–$0.00299 each depending on your Apify plan. Every exported record also costs $0.00001, including bonus sections, images and videos. See the pricing table above.

Q: Can I filter by date? A: Yes. Use timeFilter with values: past day, past week, past month, or past year.

---

Support

• Email: max@mapa.slmail.me
• Bugs: Issues tab
• Features: Email or issues

Legal Compliance

Extracts publicly available search results from Brave Search. Users must comply with applicable data protection regulations (GDPR, CCPA).

---

Structured search results from Brave — web links, discussions, news, locations, knowledge panels, images, videos, and more in one query.