Brave Search API — поисковый API для AI-агентов

Brave Search API — независимый поисковый API с собственным индексом более 30 миллиардов веб-страниц. Даёт AI-приложениям, чат-ботам и агентам доступ к актуальным данным из интернета в реальном времени.

Что это такое

Brave Search API даёт программный доступ к тому же индексу, на котором работает поисковик Brave Search: более 30 миллиардов страниц и свыше 100 миллионов обновлений ежедневно. Краулер, индексация и модели ранжирования собственные: Brave отдельно подчёркивает, что не перепаковывает выдачу Google или Bing.

Индекс дополняется данными Web Discovery Project: пользователи браузера Brave добровольно и анонимно делятся данными о посещённых страницах, код проекта открыт.

Среди клиентов, которых Brave указывает на своём сайте: AWS, Snowflake, Shopify, Mistral AI, Cohere, Chegg, Kagi, Firecrawl, Turnitin. Подписка доступна и через AWS Marketplace. Сервис имеет аттестацию SOC 2 Type II.

Основные возможности

Web Search

Основной endpoint для поиска по ключевым словам. Возвращает заголовки, описания и URL, а также блоки новостей, видео и изображений. На плане Search доступны до пяти дополнительных сниппетов на результат и schema-обогащённые данные для популярных форматов.

Автодополнение и проверка орфографии — это отдельные endpoints и отдельный тариф, а не часть веб-поиска.

LLM Context

LLM Context — endpoint, запущенный 6 февраля 2026 года. Он отдаёт не список ссылок, а уже извлечённое содержимое страниц: релевантные фрагменты ранжируются и собираются в компактный контекст для модели. Скрейпинг на своей стороне не нужен.

Что можно настроить:

• бюджет токенов: maximum_number_of_tokens от 1024 до 32768, по умолчанию 8192;
• число источников и фрагментов: maximum_number_of_urls, maximum_number_of_snippets;
• жёсткость фильтра релевантности: context_threshold_mode со значениями strict, balanced, lenient, disabled;
• свежесть страниц: freshness за сутки, неделю, месяц, год или произвольный диапазон дат;
• Goggles — собственные правила переранжирования, которыми можно ограничить выдачу доверенными доменами.

В ответе приходят grounding.generic с фрагментами по каждому URL и блок sources с метаданными источников.

Answers

Answers — готовый ответ с цитатами вместо сырых данных. Запущен в августе 2025 года, работает через OpenAI-совместимый endpoint res/v1/chat/completions с моделью brave. Под капотом тот же движок, что и у функции Ask Brave.

• По умолчанию на вопрос делается один поиск: ответ начинает стримиться в среднем быстрее 4,5 секунды.
• Параметр enable_research включает несколько последовательных поисков. Точнее на сложных вопросах, но ответ может занять минуты и стоит дороже.
• enable_citations и enable_entities добавляют цитаты и сущности; оба требуют включённого streaming.
• В конце ответа приходит блок usage с числом запросов, токенов и точной стоимостью вызова.

Точность: Brave заявляет state-of-the-art на бенчмарке SimpleQA без оптимизации под сам бенчмарк. Значение F1 94.1% приводилось в анонсе AI Grounding в 2025 году; в текущей документации конкретная цифра не указана.

Image & Video Search

Отдельные endpoints для поиска изображений и видео — удобно для визуальных агентов и контент-систем.

LLM Context или Answers: что выбрать

Чем Brave отличается от других поисковых API

• Собственный индекс. Brave краулит и индексирует веб сам и не является надстройкой над выдачей Google или Bing.
• Независимость от политики Big Tech. Доступ и условия не зависят от изменений в Google Programmable Search или Bing API.
• Прозрачная цена. Единый тариф $5 за тысячу запросов на плане Search, без скрытых уровней.
• Zero Data Retention доступен на enterprise-условиях, если запросы нельзя хранить у поставщика.

Прямое сравнение цен с Tavily, Exa.ai и Perplexity здесь не приводится: тарифы этих сервисов за последний год менялись несколько раз. Перед выбором сверяйтесь с их официальными страницами тарифов.

Интеграция

API Endpoints

Base URL: https://api.search.brave.com/res/v1/

• GET /llm/context и POST /llm/context — контекст для агентов и RAG
• GET /web/search — веб-поиск
• GET /images/search — изображения
• GET /videos/search — видео
• GET /news/search — новости
• POST /chat/completions — Answers через OpenAI-совместимый интерфейс
• Отдельные сервисы: Summarizer, Place Search для карт и точек на местности, Autosuggest, Spellcheck

Аутентификация

curl "https://api.search.brave.com/res/v1/web/search?q=artificial+intelligence" \
  -H "X-Subscription-Token: YOUR_API_KEY"

Пример на Python

import requests
import os

api_key = os.environ.get('BRAVE_API_KEY')
headers = {'X-Subscription-Token': api_key}

response = requests.get(
    'https://api.search.brave.com/res/v1/web/search',
    headers=headers,
    params={'q': 'OpenAI GPT-5', 'count': 10}
)

data = response.json()
for result in data['web']['results']:
    print(result['title'], result['url'])

Пример запроса к LLM Context

curl -X POST "https://api.search.brave.com/res/v1/llm/context" \
  -H "X-Subscription-Token: $BRAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "q": "чем LLM Context отличается от обычного веб-поиска",
        "count": 20,
        "maximum_number_of_tokens": 8192,
        "context_threshold_mode": "balanced"
      }'

Ключ храните в переменной окружения, а не в коде: export BRAVE_API_KEY=....

Официальные материалы для интеграции

• Skill-файлы Brave для LLM Context и Answers — репозиторий brave/brave-search-skills
• AWS Marketplace — подписка через аккаунт AWS
• OpenAI SDK — штатный способ работы с Answers: достаточно подменить base_url

Готовые ноды и обёртки есть в агентных фреймворках и no-code-платформах, но их набор быстро меняется. Проверяйте поддержку в документации конкретного инструмента.

Проверка результата

Минимальный сценарий, чтобы убедиться, что ключ работает:

curl -s -o /dev/null -w "%{http_code}\n" \
  "https://api.search.brave.com/res/v1/llm/context?q=brave+search+api" \
  -H "X-Subscription-Token: $BRAVE_API_KEY"

Как читать результат:

В каждом ответе приходят заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset — по ним виден остаток квоты за секунду и за месяц. Неуспешные запросы не тарифицируются и не расходуют квоту. Таймаут на запрос ставьте порядка 30 секунд.

Тарифы и лимиты

Кредиты $5 начисляются на каждый план автоматически и списываются по факту использования.

Лимиты считаются в скользящем окне длиной одна секунда, поэтому равномерный поток запросов безопаснее коротких всплесков.

Ограничения и когда не подходит

• Нет по-настоящему бесплатного входа. Для новых аккаунтов требуется карта, а бесплатный объём ограничен кредитами.
• Answers ограничен двумя запросами в секунду. Для высоконагруженного чат-интерфейса потребуется очередь или enterprise-план.
• Это поисковый индекс, а не скрейпер. Страницы, закрытые от поисковых роботов — через noindex или запрет для googlebot, — в индекс Brave не попадают. Для такого контента нужен отдельный инструмент сбора данных.
• Индекс собственный, а не Google. Для задач, где важна именно выдача Google, нужен другой поставщик.
• Хранение результатов требует отдельных прав. Сохранять выдачу, в том числе для обучения или дообучения модели, можно только на плане с явно предоставленными правами на хранение; общие условия этого не разрешают.

Для кого это

• Разработчики AI-агентов — реальные данные из веба в реальном времени
• RAG-системы — свежий контекст для языковых моделей
• Исследовательские боты — автоматический сбор информации
• Аналитические системы — мониторинг новостей и трендов
• Чат-боты — ответы с актуальными данными

Ссылки

• Сайт: brave.com/search/api
• Dashboard: api-dashboard.search.brave.com
• Документация: api-dashboard.search.brave.com/documentation
• LLM Context API: документация endpoint
• Тарифы: страница цен

По теме

• Блог: Контекст — это всё: как запустить SEO-агента в OpenClaw
• Статья: 25 продвинутых сценариев для OpenClaw: от почты до трекинга здоровья
• База знаний: Tavily — Search API для AI-агентов