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

- **Provider**: brave-web-search
- **Model ID**: brave/web-search
- **Category**: web_search
- **Credits**: 12 per request
- **Pricing Type**: fixed

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `q` (string, **required**): The search query (max 600 characters, 75 words).
- `country` (string, optional): Country the results come from (ALL for worldwide). (Default: `US`; Options: `AR`, `AU`, `AT`, `BE`, `BR`, `CA`, `CL`, `DK`, `FI`, `FR`, `DE`, `GR`, `HK`, `IN`, `ID`, `IT`, `JP`, `KR`, `MY`, `MX`, `NL`, `NZ`, `NO`, `CN`, `PL`, `PT`, `PH`, `RU`, `SA`, `ZA`, `ES`, `SE`, `CH`, `TW`, `TR`, `GB`, `US`, `ALL`)
- `offset` (integer, optional): Pages of results to skip (0-9), for pagination. (Default: `0`; Range: min: 0, max: 9)
- `text_decorations` (boolean, optional): Include highlight markers in snippets. (Default: `true`)
- `safesearch` (string, optional): Adult content filtering. (Default: `moderate`; Options: `off`, `moderate`, `strict`)
- `result_filter` (string, optional): Comma-separated result types to return: discussions, faq, infobox, news, query, videos, web, locations. Omit for all.
- `count` (integer, optional): Number of web results (1-20); may return fewer. (Default: `20`; Range: min: 1, max: 20)
- `ui_lang` (string, optional): UI language as language-COUNTRY, e.g. ko-KR, en-US (default en-US).
- `units` (string, optional): Measurement system for results. (Options: `metric`, `imperial`)
- `freshness` (string, optional): Page age filter - pd (24h), pw (7 days), pm (31 days), py (365 days) or YYYY-MM-DDtoYYYY-MM-DD.
- `spellcheck` (boolean, optional): Spell-check the query and search with the correction. (Default: `true`)
- `goggles` (array, optional): Up to 3 Goggles (URL or inline definition) to re-rank results.
- `operators` (boolean, optional): Apply search operators in the query (site:, quotes, -term). (Default: `true`)
- `search_lang` (string, optional): Search language, e.g. ko, en, ja, en-gb, zh-hans. (Default: `en`)
- `extra_snippets` (boolean, optional): Return up to 5 extra excerpts per result. (Default: `false`)

## Example Request

```json
{
  "model": "brave/web-search",
  "input": {
    "count": 10,
    "q": "생성형 AI API 비교",
    "country": "KR",
    "search_lang": "ko"
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "brave-web-search",
  "model": "brave/web-search",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null,
  "credits_used": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

When the job is `completed`, `result` holds the output URL(s) or data and `credits_used` the net credits charged. When it is `failed`, `error` and `error_code` say why and the charge is refunded.

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Pricing

- 12 credits per request

These are list prices. The amount charged is rounded, and large charges are discounted progressively. `POST /predictions/estimate` with the same `model` and `input` returns the charge for that input without creating a job (an estimate when the price depends on the output).

## Output Type

json

## Tags

brave, search, web-search, serp

## Documentation

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