Веб-поиск — BazaarLink API

Документация API Ссылка SDK Ссылка Агентное использование AI Навыки

Веб-поиск

Совместимый с Tavily `POST /v1/search` возвращает ранжированные результаты без вызова языковой модели. Аутентификация выполняется через `Authorization: Bearer <BazaarLink key>` или `api_key` в JSON body. Используйте базовый URL `https://api.bazaarlink.ai/v1` либо полностью поддерживаемый старый URL `https://bazaarlink.ai/api/v1`. Все поля зафиксированной схемы OpenAPI проверяются; неизвестные поля игнорируются. Параметры глубины, даты, языка, доменов, изображений, ответа и raw content соответствуют контракту ниже. Для бесплатной квоты нужна подтверждённая почта; квота сбрасывается ежедневно в 00:00 UTC. Для аккаунтов без баланса и пополненных аккаунтов действуют разные квоты; текущие значения N/M берутся из базы через `getPublicFreeSearchAllowance()`, актуальную дневную квоту смотрите на pricing page. После исчерпания бесплатной квоты при отсутствии баланса возвращается 432. Цена клиента равна числу credits, умноженному на цену одного credit, настроенную администратором. Цена в долларах не зашита; смотрите pricing page и `usage.cost` каждого ответа. Python: `TavilyClient(api_key=..., api_base_url='https://api.bazaarlink.ai/v1')`; JS: `tavily({ apiKey, apiBaseURL })`; LangChain: `TavilySearch(api_base_url=...)`.

POST/v1/search

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

queryобязательно

string

Поисковый запрос для выполнения.

required; non-empty search query

Example: who is Leo Messi?

search_depth

string

Управляет задержкой, релевантностью и формированием содержимого результатов. По умолчанию `basic`; `basic`, `fast` и `ultra-fast` стоят по 1 credit, а `advanced` — 2 credits.

default: basic

advancedbasicfastultra-fast

chunks_per_source

integer

Максимальное число релевантных фрагментов контента на источник. По умолчанию 3; допустимый диапазон 1–3. Доступно для `advanced`, `basic` и `fast`.

default: 3; 1..3

max_results

integer

Максимальное число возвращаемых результатов поиска. По умолчанию 10; допустимый диапазон 0–20.

default: 10; 0..20

Example: 1

topic

string

Тема поиска. По умолчанию `general`; используйте `news` для текущих новостей и `finance` для финансового контента.

default: general

generalnewsfinance

time_range

string

Фильтрует по дате публикации или обновления. По умолчанию не задано. Допустимые значения: `day`, `week`, `month`, `year`, `d`, `w`, `m`, `y`.

default: null

dayweekmonthyeardwmy

start_date

string

Возвращает результаты, опубликованные или обновлённые после этой даты. Формат: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-02-09

end_date

string

Возвращает результаты, опубликованные или обновлённые до этой даты. Формат: YYYY-MM-DD.

default: null; format YYYY-MM-DD

Example: 2025-12-29

include_published_date

boolean

Добавляет в каждый результат предполагаемую дату публикации или обновления. Для темы `news` включается автоматически. По умолчанию `false`.

default: false

filter_by_published_date

boolean

Удаляет результаты вне окна `time_range`, `start_date` или `end_date`, включая результаты без распознаваемой даты. По умолчанию `false`; значение `true` также включает `include_published_date`.

default: false

include_answer

boolean | string

Добавляет ответ, созданный LLM. По умолчанию `false`; принимает boolean или `basic`/`advanced`.

default: false

basicadvanced

include_raw_content

boolean | string

Добавляет очищенное HTML-содержимое каждого результата. По умолчанию `false`; принимает boolean или `markdown`/`text`.

default: false

markdowntext

include_images

boolean

Добавляет изображения, связанные с запросом, на верхнем уровне и изображения источника внутри каждого результата. По умолчанию `false`.

default: false

include_image_descriptions

boolean

Если `include_images` равно `true`, добавляет описание к каждому изображению. По умолчанию `false`.

default: false

include_favicon

boolean

Добавлять ли URL favicon для каждого результата. По умолчанию `false`.

default: false

include_domains

string[]

Ограничивает результаты указанными доменами; максимум 300 доменов. По умолчанию пустой массив.

default: []; maximum 300 items

exclude_domains

string[]

Исключает результаты указанных доменов; максимум 150 доменов. По умолчанию пустой массив.

default: []; maximum 150 items

include_domains_mode

string

Управляет применением `include_domains`. `restrict` ограничивает результаты этими доменами, а `prefer` отдаёт им приоритет, но может вернуть другие. Требует `include_domains`, иначе возвращается 400. По умолчанию не задано.

default: null; requires include_domains

restrictprefer

country

string

Повышает приоритет результатов из выбранной страны. Доступно только при `topic: general`. По умолчанию не задано.

default: null; only when topic is general

afghanistanalbaniaalgeriaandorraangolaargentinaarmeniaaustraliaaustriaazerbaijanbahamasbahrainbangladeshbarbadosbelarusbelgiumbelizebeninbhutanboliviabosnia and herzegovinabotswanabrazilbruneibulgariaburkina fasoburundicambodiacamerooncanadacape verdecentral african republicchadchilechinacolombiacomoroscongocosta ricacroatiacubacyprusczech republicdenmarkdjiboutidominican republicecuadoregyptel salvadorequatorial guineaeritreaestoniaethiopiafijifinlandfrancegabongambiageorgiagermanyghanagreeceguatemalaguineahaitihondurashungaryicelandindiaindonesiairaniraqirelandisraelitalyjamaicajapanjordankazakhstankenyakuwaitkyrgyzstanlatvialebanonlesotholiberialibyaliechtensteinlithuanialuxembourgmadagascarmalawimalaysiamaldivesmalimaltamauritaniamauritiusmexicomoldovamonacomongoliamontenegromoroccomozambiquemyanmarnamibianepalnetherlandsnew zealandnicaraguanigernigerianorth koreanorth macedonianorwayomanpakistanpanamapapua new guineaparaguayperuphilippinespolandportugalqatarromaniarussiarwandasaudi arabiasenegalserbiasingaporeslovakiasloveniasomaliasouth africasouth koreasouth sudanspainsri lankasudanswedenswitzerlandsyriataiwantajikistantanzaniathailandtogotrinidad and tobagotunisiaturkeyturkmenistanugandaukraineunited arab emiratesunited kingdomunited statesuruguayuzbekistanvenezuelavietnamyemenzambiazimbabwe

language

string

Повышает приоритет результатов на выбранном языке. Принимает код ISO 639-1 или английское название языка. По умолчанию не задано.

default: null

Example: en

filter_by_language

boolean

Строго удаляет результаты, не соответствующие `language`. Требует `language`, иначе возвращается 400. По умолчанию `false`.

default: false; requires language

auto_parameters

boolean

Автоматически выбирает параметры поиска по намерению запроса. Явные значения имеют приоритет; `include_answer`, `include_raw_content` и `max_results` нужно задавать вручную. Добавляет 2 credits за запрос. По умолчанию `false`.

default: false; costs 2 credits

exact_match

boolean

Возвращает только результаты, содержащие фразы в кавычках из запроса, без синонимов и смысловых вариантов. По умолчанию `false`.

default: false

include_usage

boolean

Включать ли сведения о расходе credit в ответ. По умолчанию `false`.

default: false

safe_search

boolean

Фильтрует контент для взрослых или небезопасный контент. По умолчанию `false`; не поддерживается для `fast` и `ultra-fast`.

default: false; unsupported for fast and ultra-fast

api_key

string

Необязательное поле аутентификации в JSON body. Если Bearer-заголовок отсутствует, укажите здесь ключ BazaarLink; перед проверкой и пересылкой поле удаляется.

days

integer

Поле совместимости SDK `days`. Принимается для совместимости; по плану оно может быть передано дальше или проигнорировано и не входит в зафиксированную схему OpenAPI.

max_hours

integer

Поле совместимости SDK `max_hours`. Принимается для совместимости; по плану оно может быть передано дальше или проигнорировано и не входит в зафиксированную схему OpenAPI.

fetch_timeout

number

Поле совместимости SDK `fetch_timeout`. Принимается для совместимости; по плану оно может быть передано дальше или проигнорировано и не входит в зафиксированную схему OpenAPI.

cache_fallback

boolean

Поле совместимости SDK `cache_fallback`. Принимается для совместимости; по плану оно может быть передано дальше или проигнорировано и не входит в зафиксированную схему OpenAPI.

timeout

number

Поле `timeout`, совместимое с SDK. Принимается для совместимости; поиск использует тайм-аут сервиса, а неизвестные или неподдерживаемые поля игнорируются.

POST /v1/search

1
2
3
4
5
6
7
8
9
10
curl https://api.bazaarlink.ai/v1/search \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "latest news on open-source language models",
    "search_depth": "basic",
    "max_results": 5,
    "topic": "news",
    "time_range": "week"
  }'

Примеры ответов

Успешный ответ содержит `query`, необязательный `answer`, верхнеуровневый `images`, `results` (у каждого `title`, `url`, `content`, `score` и необязательные `raw_content`, `published_date`, `favicon`, `images`, `id`), необязательный `auto_parameters`, `response_time`, `usage` (`credits` и наше дополнительное поле `cost`) и `request_id`. `usage.cost` — цена в USD, списанная с клиента, а не COGS; `request_id` создаёт BazaarLink.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
  "query": "Who is Leo Messi?",
  "answer": "Lionel Messi is an Argentine footballer.",
  "images": [
    {
      "url": "https://example.com/messi.jpg",
      "description": "Lionel Messi"
    }
  ],
  "results": [
    {
      "title": "Lionel Messi Facts | Britannica",
      "url": "https://www.britannica.com/facts/Lionel-Messi",
      "content": "Lionel Messi is an Argentine footballer.",
      "score": 0.81025416,
      "raw_content": null,
      "published_date": "Tue, 11 Mar 2025 17:00:00 GMT",
      "favicon": "https://britannica.com/favicon.png",
      "images": [
        {
          "url": "https://example.com/messi.jpg",
          "description": "Lionel Messi"
        }
      ],
      "id": "a3f9c2-04"
    }
  ],
  "auto_parameters": {
    "topic": "general",
    "search_depth": "basic"
  },
  "response_time": 1.67,
  "usage": {
    "credits": 1,
    "cost": "<customer_price_usd>"
  },
  "request_id": "123e4567-e89b-12d3-a456-426614174111"
}