Skip to main content
Core.Today
|
BraveFastHigh

Brave Web Search

Search results pages from Brave's independent index - web results plus news, videos, discussions, FAQ and infobox clusters, with country, language, freshness and Goggles controls. 12 credits per request.

12 credits
per request
Brave's independent web index (not a Google/Bing reseller)
News, videos, discussions, FAQ and infobox clusters
Up to 5 extra snippets per result
Freshness filters, operators and Goggles

Run it right now

Test this model instantly in the Console Playground โ€” no code required

Sign in to try

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "brave/web-search",
  "input": {
    "q": "์ƒ์„ฑํ˜• AI API ๋น„๊ต",
    "country": "KR",
    "search_lang": "ko",
    "count": 10
  }
}'

Parameters

ParameterTypeRequiredDefaultDescription
qstringYes-The search query (max 600 characters, 75 words).
countrystringNoUSCountry the results come from (ALL for worldwide).
search_langstringNoenSearch language, e.g. ko, en, ja, en-gb, zh-hans.
ui_langstringNo-UI language as language-COUNTRY, e.g. ko-KR, en-US (default en-US).
countintegerNo20Number of web results (1-20); may return fewer.
offsetintegerNo0Pages of results to skip (0-9), for pagination.
safesearchstringNomoderateAdult content filtering.
offmoderatestrict
freshnessstringNo-Page age filter - pd (24h), pw (7 days), pm (31 days), py (365 days) or YYYY-MM-DDtoYYYY-MM-DD.
result_filterstringNo-Comma-separated result types to return: discussions, faq, infobox, news, query, videos, web, locations. Omit for all.
extra_snippetsbooleanNofalseReturn up to 5 extra excerpts per result.
spellcheckbooleanNotrueSpell-check the query and search with the correction.
text_decorationsbooleanNotrueInclude highlight markers in snippets.
unitsstringNo-Measurement system for results.
metricimperial
gogglesarrayNo-Up to 3 Goggles (URL or inline definition) to re-rank results.
operatorsbooleanNotrueApply search operators in the query (site:, quotes, -term).

Common Parameters

Common parameters used when calling POST /v1/predictions.

ParameterTypeRequiredDefaultDescription
modelstringYes-Model identifier
inputobjectYes-Object containing the model-specific parameters from the table above
output_folderstringNo-Folder path for output files (max 256 chars, '..' not allowed)
webhook_urlstringNo-Webhook URL to call on completion
is_publicbooleanNofalseIf true, output files are also available via permanent public URLs

Examples

Basic request

A typical request with the most common options.

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "brave/web-search",
  "input": {
    "q": "์ƒ์„ฑํ˜• AI API ๋น„๊ต",
    "country": "KR",
    "search_lang": "ko",
    "count": 10
  }
}'

Tips & Best Practices

1The result is the provider's JSON as-is (query, web, news, videos, discussions, faq, infobox, mixed)
2Links in the result point to the original pages - nothing is copied to your storage
3Use result_filter=web for web results only; use brave/llm-context when the results go to an LLM

Use Cases

Search features in apps
SERP data for analysis
Agents that need full result pages