web-search
Web search with ranked results, snippets, and support for freshness filters, SafeSearch, and custom ranking via Goggles.
- Returns structured results across multiple types: web pages, news, videos, discussions, FAQ, infobox, and locations in a single response
- Supports freshness filtering (past day/week/month/year or custom date ranges), SafeSearch levels, and location-aware results via headers
- Goggles enable custom result ranking: boost trusted sources, suppress spam, or build focused search scopes using inline rules or hosted filters
- Rich data enrichments for weather, stocks, currency, sports, and other vertical queries via callback workflow
- Includes search operators (site, filetype, intitle, language, exact match, AND/OR/NOT) and optional spellcheck correction
Web Search
Requires API Key: Get one at https://api.search.brave.com
Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe
Quick Start (cURL)
Basic Search
curl -s "https://api.search.brave.com/res/v1/web/search?q=python+web+frameworks" \
-H "Accept: application/json" \
-H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"
With Parameters
curl -s "https://api.search.brave.com/res/v1/web/search" \
-H "Accept: application/json" \
More from brave/brave-search-skills
news-search
USE FOR news search. Returns news articles with title, URL, description, age, thumbnail. Supports freshness and date range filtering, SafeSearch filter and Goggles for custom ranking.
526images-search
USE FOR image search. Returns images with title, source URL, thumbnail. Supports SafeSearch filter. Up to 200 results.
452llm-context
USE FOR RAG/LLM grounding. Returns pre-extracted web content (text, tables, code) optimized for LLMs. GET + POST. Adjust max_tokens/count based on complexity. Supports Goggles, local/POI. For AI answers use answers. Recommended for anyone building AI/agentic applications.
257videos-search
USE FOR video search. Returns videos with title, URL, thumbnail, duration, view count, creator. Supports freshness filters, SafeSearch, pagination.
247answers
USE FOR AI-grounded answers via OpenAI-compatible /chat/completions. Two modes: single-search (fast) or deep research (enable_research=true, thorough multi-search). Streaming/blocking. Citations.
232local-pois
USE FOR getting local business/POI details. Requires POI IDs obtained from web-search (with result_filter=locations). Returns full business information including ratings, hours, contact info. Max 20 IDs.
209