Аккаунт

Создать исследовательскую задачу Tavily

Ставит асинхронную исследовательскую задачу в очередь. Обязательное поле OpenAPI — input (не query); model принимает mini, pro или auto, а stream=true возвращает поток SSE. Рекомендуется Bearer-аутентификация; также поддерживается необязательный api_key в JSON body. Исследования оплачиваются по факту на основе реально использованных credits: динамический диапазон mini — 4–110 credits, pro — 15–250, auto следует выбранному уровню. Бесплатная квота не применяется к research; она покрывает search, extract, crawl, map и :online.

POST/v1/research

Авторизация

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

string · header

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

Тело

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

string

Исследовательская задача или вопрос. Поле OpenAPI — input; query не является псевдонимом.

Example: What are the latest developments in AI?

model

string

Уровень исследовательского агента: mini для узких вопросов, pro для многостороннего исследования или auto.

miniproauto

Example: mini

stream

boolean

Передавать ли результаты исследования потоком SSE; по умолчанию false.

Example: false

output_schema

object

JSON Schema для результата исследования; properties обязателен, required — необязателен.

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

object

Определения свойств выходного объекта; каждое значение — поле JSON Schema.

required

string[]

Имена обязательных свойств выходного объекта.

Example: ["company"]

citation_format

string

Формат цитирования в отчёте; по умолчанию numbered.

numberedmlaapachicago

Example: numbered

include_domains

string[]

Мягкое предпочтение источников; другие домены также могут появиться в отчёте.

maxItems: 20

Example: ["sec.gov"]

exclude_domains

string[]

Жёсткий список блокировки доменов источников и их поддоменов.

maxItems: 20

Example: ["reddit.com"]

output_length

string

Целевой размер ответа; это не жёсткие ограничения, по умолчанию standard.

shortstandardlong

Example: standard

files

array<object>

Источники .txt, .md или .json в Base64; до 5 файлов и 80 000 слов суммарно.

maxItems: 5

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

string

Имя файла с расширением .txt, .md или .json.

Example: brief.md

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

string

Содержимое файла в кодировке Base64.

Example: <base64-encoded file contents>

type

string

Кодировка data; по умолчанию base64.

base64

Example: base64

api_key

string

Необязательный credential BazaarLink в body; предпочтителен Authorization: Bearer, после проверки поле удаляется.

Example: YOUR_BAZAARLINK_API_KEY

POST /v1/research

1
2
3
4
curl -X POST https://api.bazaarlink.ai/v1/research \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"What are the latest developments in AI?","model":"mini"}'

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

Исследовательская задача поставлена в очередь; возвращаются request_id, created_at, статус pending, input, model и response_time.

1
2
3
4
5
6
7
8
{
  "request_id": "123e4567-e89b-12d3-a456-426614174111",
  "created_at": "2025-01-15T10:30:00Z",
  "status": "pending",
  "input": "What are the latest developments in AI?",
  "model": "mini",
  "response_time": 1.23
}