База знаний

Tavily — Search API для AI-агентов

Как подключить AI-агента к вебу через Tavily: endpoints, кредиты и тарифы, лимиты запросов и проверка ключа. Данные на 1 августа 2026.

Опубликовано 26.02.2026 Обновлено 01.08.2026

API и данные ИИ-агенты

Практический справочник по Tavily: как подключить AI-агента к живому вебу, из чего состоит API, как считаются кредиты и какие лимиты действуют на бесплатном ключе.

📌

Проверено 1 августа 2026. В феврале 2026 года Tavily перешла к Nebius: сайт компании подписан как «Tavily by Nebius». Тарифы, стоимость кредитов и лимиты меняются, поэтому цифры сверяйте с официальными страницами Credits & Pricing и Rate Limits.

Что такое Tavily

Tavily — поисковый API, созданный для AI-агентов. Он закрывает доступ агента к актуальной информации из интернета: вместо собственных парсеров и борьбы с антибот-защитой вы делаете один HTTP-запрос и получаете очищенный текст, готовый для языковой модели.

Платформа основана в 2024 году, головной офис в Нью-Йорке. 10 февраля 2026 года Nebius сообщила о соглашении о покупке Tavily; сумму в 275 млн долларов назвал Bloomberg со ссылкой на источники, официально условия сделки не раскрывались. Основатель и CEO Ротем Вайс с командой переходит в Nebius. На стороне API смена владельца пока не отразилась: документация описывает те же адреса методов, ключи и SDK.

💡

Кредит (API credit) — внутренняя единица тарификации Tavily. Один запрос может стоить от одного до нескольких сотен кредитов в зависимости от метода и глубины обработки, поэтому «1 000 кредитов» и «1 000 запросов» — не одно и то же.

Пять методов API

Search — веб-поиск

Возвращает не просто список ссылок, а извлечённое и очищенное содержимое найденных страниц. Поддерживает две глубины: basic (сниппеты, быстрее и дешевле) и advanced (полное извлечение контента). Умеет ограничивать выдачу списком доменов.

Extract — извлечение контента

Достаёт чистый текст из указанных URL, обходя JavaScript, рекламу и всплывающие окна. Оплачиваются только успешные извлечения.

Map — карта сайта

Строит список страниц сайта, чтобы понять его структуру до глубокого разбора. Поддерживает натуральные instructions: описание того, какие разделы вам нужны.

Crawl — обход сайта

Граф-обход сайта с параллельным извлечением содержимого. Полезен для документации и баз знаний. Технически это сумма двух операций: карта плюс извлечение.

Research — исследовательский отчёт

Асинхронная задача: Tavily сама формирует запросы, собирает источники и возвращает структурированный отчёт. Есть две модели, mini и pro, которые различаются глубиной и стоимостью.

Подключение

Endpoints

Base URL: https://api.tavily.com

POST /search — веб-поиск
POST /extract — извлечение контента
POST /map — карта сайта
POST /crawl — обход сайта
POST /research — создание исследовательской задачи

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

Ключ передаётся в заголовке Authorization. Ключи бывают двух типов: Development и Production, и от типа зависят лимиты запросов.

# ключ храните в переменной окружения, а не в коде
export TAVILY_API_KEY="tvly-..."

curl -X POST https://api.tavily.com/search \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TAVILY_API_KEY" \
  -d '{"query": "latest AI agent frameworks", "search_depth": "basic"}'

Официальные SDK

Python: pip install tavily-python
JavaScript / TypeScript: npm install @tavily/core
Исходники и дополнительные инструменты, включая CLI: github.com/tavily-ai

⚠️

Внимание: ключ вида tvly-... даёт доступ к вашему балансу кредитов. Не коммитьте его в репозиторий и не передавайте агенту в открытом виде: подключайте через переменную окружения или менеджер секретов.

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

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

Получите ключ в app.tavily.com и запишите его в переменную окружения TAVILY_API_KEY.
Выполните запрос из раздела «Аутентификация».
В ответе должен прийти JSON со статусом 200 и полем results: массив найденных страниц, у каждой есть title, url, content и score.
Если вместо результата приходит 401, ключ передан неверно или недействителен. Ответ 429 означает превышение лимита запросов.
Откройте дашборд в app.tavily.com и убедитесь, что счётчик израсходованных кредитов увеличился: базовый поиск списывает 1 кредит.

Перед тем как встраивать вызов в агента, прогоните тот же запрос в Playground: там видно, как меняется выдача при разных параметрах.

Сколько стоит каждый вызов

Тарификация считается в кредитах и зависит от метода и глубины обработки.

Метод	Стоимость
Search `basic`	1 кредит за запрос
Search `advanced`	2 кредита за запрос
Extract `basic`	1 кредит за каждые 5 успешных извлечений
Extract `advanced`	2 кредита за каждые 5 успешных извлечений
Map	1 кредит за каждые 10 страниц, с `instructions` — 2 кредита
Crawl	Стоимость карты плюс стоимость извлечения
Research `mini`	От 4 до 110 кредитов за задачу
Research `pro`	От 15 до 250 кредитов за задачу

Пример расчёта для Crawl: обход 10 страниц с базовым извлечением стоит 1 кредит за карту и 2 кредита за извлечение, итого 3 кредита. С продвинутым извлечением те же 10 страниц обойдутся в 5 кредитов.

⚖️

Компромисс: Research экономит вам оркестрацию, но его стоимость плавающая. Одна задача на модели pro в худшем случае съедает четверть месячного бесплатного лимита. Если бюджет важнее глубины, собирайте цепочку из Search и Extract вручную и считайте кредиты сами.

Тарифы

План	Кредитов в месяц	Цена	Цена кредита
Researcher	1 000	Бесплатно	—
Project	4 000	30 $	0,0075 $
Bootstrap	15 000	100 $	0,0067 $
Startup	38 000	220 $	0,0058 $
Growth	100 000	500 $	0,005 $
Pay as you go	По расходу	0,008 $ за кредит	0,008 $
Enterprise	По договору	По договору	По договору

Кредиты обнуляются первого числа каждого месяца независимо от даты оплаты. Режим pay-as-you-go включается поверх плана: когда месячные кредиты заканчиваются, списание идёт по 0,008 $ за кредит вместо ошибки.

Лимиты запросов

Лимиты зависят от типа ключа, а не от тарифа.

Что вызываем	Development	Production
Search, Extract, Map	100 запросов в минуту	1 000 запросов в минуту
Crawl	100 в минуту	100 в минуту
Создание задач Research	20 в минуту	20 в минуту
Endpoint расхода кредитов	10 за 10 минут	10 за 10 минут

При превышении лимита приходит 429 Too Many Requests с заголовком retry-after и числом секунд до следующей попытки. В агенте это обрабатывается повтором с задержкой из этого заголовка.

🔴

Критично для продакшна: production-ключ выдаётся только при активном платном плане или включённом pay-as-you-go. На бесплатном тарифе вы остаётесь в рамках 100 запросов в минуту, и это стоит учитывать до нагрузочного теста.

На что хватит 1 000 бесплатных кредитов

Бесплатный план даёт 1 000 кредитов в месяц без привязки карты. Считать нужно в кредитах, а не в запросах.

Утренний дайджест по 5 темам с продвинутым поиском: 10 кредитов в день, около 300 в месяц.
Еженедельный мониторинг конкурентов, 20 продвинутых запросов за проход: около 80 кредитов в месяц.
RAG-бот на сайте с базовым поиском, 10 обращений в день: около 300 кредитов в месяц.
Подготовка контента, 3 материала в неделю по два поиска и пять извлечений: около 40 кредитов в месяц.
Полноценные отчёты Research: один запуск на pro может стоить до 250 кредитов, поэтому четыре тяжёлых отчёта исчерпывают месячный лимит целиком.

Набор регулярных задач небольшой команды в бесплатный лимит укладывается ровно до тех пор, пока вы не начинаете гонять Research по расписанию.

💡

Совет: кешируйте результаты частых запросов и обновляйте их раз в сутки. Кеш и переход с advanced на basic там, где хватает сниппетов, дают самую большую экономию кредитов.

Когда Tavily, а когда альтернатива

Задача	Что выбрать
Универсальный доступ агента к вебу: поиск, извлечение и обход в одном API	Tavily
Готовые исследовательские отчёты без своей оркестрации	Tavily Research или Exa Deep
Массовый скрейпинг сотен страниц и структурированные данные с сайтов	Специализированные скрейпинг-API
Минимальная задержка на большом объёме простых запросов	Проверять на своих запросах: разброс по скорости между API большой

Публичные бенчмарки поисковых API устаревают за недели и меряют не ваши сценарии. Перед выбором прогоните 20–30 реальных запросов через два-три сервиса и сравните полноту выдачи и стоимость одного полезного ответа.

Ограничения

Публичных данных о качестве выдачи по языкам нет: если работаете не с английским, проверяйте на своих запросах.
Стоимость Research непредсказуема заранее: планируйте по верхней границе.
Production-ключи недоступны без платного плана или pay-as-you-go.
Кредиты обнуляются первого числа месяца; перенос остатка в документации не описан, поэтому рассчитывать на него не стоит.
Компания сменила владельца в 2026 году, поэтому условия и состав тарифов стоит перепроверять перед долгими обязательствами.

Ссылки

Сайт: tavily.com
Документация: docs.tavily.com
Кредиты и цены: docs.tavily.com/documentation/api-credits
Лимиты запросов: docs.tavily.com/documentation/rate-limits
Playground: app.tavily.com/playground
Репозитории и SDK: github.com/tavily-ai

Следующий шаг

Сравните Tavily с прямым конкурентом по цене и лимитам: Brave Search API — поисковый API для AI-агентов

Связанные материалы

Поисковый API — это одна деталь агентного контура, и цена ошибки видна не на демо, а на счёте в конце месяца. Разбор пригодится тем, кто уже собирает агента с доступом к вебу и выбирает, на чём считать бюджет.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov

Если хотите разобрать свою задачу — напишите мне

Можно прийти с идеей, черновым контекстом или уже живой задачей. Помогу быстро понять, где реальный следующий шаг, а где лишний шум.

Напишите мне в Телеграм Мой Телеграм канал

Обычно хватает 2–3 сообщений, чтобы понять, могу ли я здесь реально помочь и в каком формате лучше двигаться дальше.