Web search for AI agents from Brave's independent index - returns pre-extracted, relevance-ranked snippets per source, sized to a token budget, ready to drop into an LLM prompt. 12 credits per request.
Test this model instantly in the Console Playground โ no code required
Copy usage instructions for Claude, ChatGPT, or other AI
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/llm-context",
"input": {
"q": "latest AI video generation models",
"country": "US",
"search_lang": "en",
"maximum_number_of_tokens": 4096
}
}'| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | - | The search query (max 600 characters, 75 words). |
country | string | No | US | Country the results come from (ALL for worldwide). |
search_lang | string | No | en | Search language, e.g. ko, en, ja, en-gb, zh-hans. |
count | integer | No | - | Search results considered for context selection (1-50, default 20). |
maximum_number_of_urls | integer | No | - | Max distinct URLs in the context (1-50, default 20). |
maximum_number_of_tokens | integer | No | - | Approximate max tokens in the context (1024-32768, default 8192). |
maximum_number_of_snippets | integer | No | - | Max text snippets in the context (1-256, default 50). |
maximum_number_of_tokens_per_url | integer | No | - | Max tokens per URL (512-8192, default 4096). |
maximum_number_of_snippets_per_url | integer | No | - | Max snippets per URL (1-100, default 50). |
context_threshold_mode | string | No | - | Relevance threshold for including content - strict keeps less, lenient keeps more. disabledstrictlenientbalanced |
freshness | string | No | - | Page age filter - pd (24h), pw (7 days), pm (31 days), py (365 days) or YYYY-MM-DDtoYYYY-MM-DD. |
safesearch | string | No | - | Adult content filtering. offmoderatestrict |
spellcheck | boolean | No | true | Spell-check the query and search with the correction. |
goggles | array | No | - | Up to 3 Goggles (URL or inline definition) to re-rank results. |
enable_source_metadata | boolean | No | false | Add site name, favicon, thumbnail and description to sources. |
Common parameters used when calling POST /v1/predictions.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
model | string | Yes | - | Model identifier |
input | object | Yes | - | Object containing the model-specific parameters from the table above |
output_folder | string | No | - | Folder path for output files (max 256 chars, '..' not allowed) |
webhook_url | string | No | - | Webhook URL to call on completion |
is_public | boolean | No | false | If true, output files are also available via permanent public URLs |
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/llm-context",
"input": {
"q": "latest AI video generation models",
"country": "US",
"search_lang": "en",
"maximum_number_of_tokens": 4096
}
}'POST /v1/predictions