acceptenum
Поддерживаемый тип медиа по умолчанию - application/json.
api-versionstring
Версия API для использования. Она обозначается в формате ГГГГ-ММ-ДД. По умолчанию используется последняя доступная версия. Подробнее о версионировании API читайте на странице https://api-dashboard.search.brave.com/documentation/guides/versioning.
cache-controlstring
Brave Search по умолчанию возвращает кэшированный контент. Чтобы предотвратить кэширование, задайте заголовок Cache-Control: no-cache. Сейчас это делается по мере возможности.
context_threshold_modeenum
Режим, используемый для определения порога включения контента в контекст. По умолчанию — сбалансированный.
countinteger
Максимальное количество результатов поиска, учитываемых при выборе данных контекста LLM. По умолчанию — 20, максимум — 50.
countryenum
Страна поискового запроса, из которой поступают результаты. Строка страны ограничена двухбуквенными кодами стран из числа поддерживаемых.
enable_localboolean
Включать ли локальный возврат. Если не задавать это значение, то будет автоопределение, и локальный возврат будет использоваться, если предоставлены какие-либо заголовки локализации.
enable_source_metadataboolean
Включает обогащение метаданных источников (site_name, favicon) в атрибуте sources ответа.
freshnessenum | string
Фильтрует результаты поиска по времени их обнаружения. Поддерживаются следующие значения: 'pd' — обнаружено за последние 24 часа. 'pw' — обнаружено за последние 7 дней. 'pm' — обнаружено за последние 31 день. 'py' — обнаружено за последние 365 дней. 'YYYY-MM-DDtoYYYY-MM-DD' — также поддерживается указание временного диапазона, например, 2022-04-01to2022-07-30.
gogglesstring | string[]
Goggles действуют как пользовательская повторная сортировка поверх поискового индекса Brave. Параметр поддерживает как URL, где размещён Goggle, так и определение самого Goggle. Можно передать несколько URL и/или определений Goggle в виде массива. Подробнее см. в репозитории Goggles (например, https://github.com/brave/goggles-quickstart).
maximum_number_of_snippetsinteger
Максимальное количество различных фрагментов (или отрывков текста), которые можно включить в контекст LLM. По умолчанию — 50, максимум — 256.
maximum_number_of_snippets_per_urlinteger
Максимальное количество сниппетов, включаемых на каждый URL. По умолчанию 50, максимум 100.
maximum_number_of_tokensinteger
Приблизительное максимальное количество токенов для включения в контекст. По умолчанию 8192, максимум 32768.
maximum_number_of_tokens_per_urlinteger
Максимальное количество токенов на один URL. По умолчанию — 4096, максимум — 8192.
maximum_number_of_urlsinteger
Максимальное количество различных URL для включения в контекст LLM.
querystringобязательный
Поисковый запрос пользователя. Запрос не может быть пустым. Максимум 400 символов и 50 слов в запросе.
search_langenum
Языковые предпочтения поиска. Код языка длиной не менее 2 символов, для которого предоставляются результаты поиска.
spellcheckboolean
Включать ли проверку орфографии для запроса.
user-agentstring
User agent, отправляющий запрос. Brave Search может использовать user agent, чтобы показывать разный контент в зависимости от устройства, указанного в строке. User agent должен соответствовать стандартным строкам браузерных агентов на каждой платформе. Подробнее о формировании user agent смотрите в RFC 9110.
x-loc-citystring
Общее название города клиента
x-loc-countrystring
Двухбуквенный код страны клиента. Список кодов стран см. в ISO 3166-1 alpha-2.
x-loc-latnumber
Широта географического местоположения клиента в градусах, чтобы предоставлять релевантные локальные результаты. Широта должна быть больше или равна -90.0 градусов и меньше или равна +90.0 градусов.
x-loc-longnumber
Долгота географического местоположения клиента в градусах, чтобы показывать релевантные локальные результаты. Долгота должна быть больше или равна -180.0 и меньше или равна +180.0 градусов.
x-loc-postal-codestring
Почтовый индекс клиента
x-loc-statestring
Код длиной до трёх символов, обозначающий штат или регион клиента. Регион — это подразделение первого уровня (самое широкое или наименее конкретное) в коде ISO 3166-2.
x-loc-state-namestring
Название штата/региона клиента. Регион - это подразделение первого уровня (самое широкое или наименее конкретное) кода ISO 3166-2.