# Brave Web Search - Core.Today AI API

> 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.

- **Provider**: Brave
- **Model ID**: brave/web-search
- **Category**: Web Search
- **Credits**: 12 per request
- **Speed**: Fast
- **Quality**: High

## Features
- 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

## Use Cases
- Search features in apps
- SERP data for analysis
- Agents that need full result pages

## API Endpoint

Base URL: https://api.core.today/v1
Create Prediction: POST /predictions
Get Status: GET /predictions/{job_id}

## Authentication
Header: X-API-Key: YOUR_API_KEY

## Input Parameters

### Required
- **q**: string - The search query (max 600 characters, 75 words).

### Optional
- **country**: string (default: US) - Country the results come from (ALL for worldwide).
- **search_lang**: string (default: en) - Search language, e.g. ko, en, ja, en-gb, zh-hans.
- **ui_lang**: string - UI language as language-COUNTRY, e.g. ko-KR, en-US (default en-US).
- **count**: integer (default: 20) - Number of web results (1-20); may return fewer.
- **offset**: integer (default: 0) - Pages of results to skip (0-9), for pagination.
- **safesearch**: string (default: moderate) - Adult content filtering.
  Options: off, moderate, strict
- **freshness**: string - Page age filter - pd (24h), pw (7 days), pm (31 days), py (365 days) or YYYY-MM-DDtoYYYY-MM-DD.
- **result_filter**: string - Comma-separated result types to return: discussions, faq, infobox, news, query, videos, web, locations. Omit for all.
- **extra_snippets**: boolean (default: false) - Return up to 5 extra excerpts per result.
- **spellcheck**: boolean (default: true) - Spell-check the query and search with the correction.
- **text_decorations**: boolean (default: true) - Include highlight markers in snippets.
- **units**: string - Measurement system for results.
  Options: metric, imperial
- **goggles**: array - Up to 3 Goggles (URL or inline definition) to re-rank results.
- **operators**: boolean (default: true) - Apply search operators in the query (site:, quotes, -term).

## Examples

### Basic request
A typical request with the most common options.
```json
{
  "model": "brave/web-search",
  "input": {
    "q": "생성형 AI API 비교",
    "country": "KR",
    "search_lang": "ko",
    "count": 10
  }
}
```

## Response Format
```json
{
  "job_id": "abc123",
  "status": "pending | processing | completed | failed",
  "result": "URL or data (when completed)"
}
```

## Usage Flow
1. POST /predictions with model and input -> receive job_id
2. GET /predictions/{job_id} -> poll until status is completed or failed
3. Result contains output URL(s)

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

## Documentation
https://api-dashboard.search.brave.com/api-reference/web/search/get