Tavily
Поиск, извлечение страниц, обход сайтов и исследования
Tavily-маршруты подходят для поиска источников, подготовки данных для RAG и задач, где нужно быстро собрать веб-контекст.
/v1/tools/tavily/search/v1/tools/tavily/extract/v1/tools/tavily/crawl/v1/tools/tavily/map/v1/tools/tavily/research/v1/tools/tavily/research/{job_id}Search
POST /v1/tools/tavily/search ищет страницы по запросу.
curl {{PUBLIC_API_BASE_URL}}/tools/tavily/search \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "latest AI regulation news",
"search_depth": "basic"
}'| Поле | Обязательность | Описание |
|---|---|---|
query | Да | Поисковый запрос. |
search_depth | Нет | Глубина поиска, если нужна более подробная выдача. |
max_results | Нет | Сколько результатов вернуть. |
include_domains | Нет | Домены, которыми нужно ограничить поиск. |
exclude_domains | Нет | Домены, которые нужно исключить. |
Extract
POST /v1/tools/tavily/extract извлекает содержимое страниц.
curl {{PUBLIC_API_BASE_URL}}/tools/tavily/extract \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://example.com/docs"],
"extract_depth": "basic"
}'| Поле | Обязательность | Описание |
|---|---|---|
urls | Да | Один URL или массив URL. |
extract_depth | Нет | Глубина извлечения. |
format | Нет | Предпочитаемый формат результата, если поддерживается. |
Crawl и Map
POST /v1/tools/tavily/crawl обходит сайт и возвращает найденные страницы с данными. POST /v1/tools/tavily/map строит карту URL без полноценного извлечения контента.
curl {{PUBLIC_API_BASE_URL}}/tools/tavily/map \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"limit": 25
}'| Поле | Обязательность | Описание |
|---|---|---|
url | Да | Начальный URL. |
limit | Нет | Максимальное количество URL или страниц. |
instructions | Нет | Подсказка, какие страницы искать. |
extract_depth | Нет | Глубина извлечения для crawl. |
Research
POST /v1/tools/tavily/research создаёт асинхронную исследовательскую задачу. В ответе Gateway возвращает публичный job_*, который можно проверить через GET /v1/tools/tavily/research/{job_id}.
curl {{PUBLIC_API_BASE_URL}}/tools/tavily/research \
-H "Authorization: Bearer gw_live_..." \
-H "Content-Type: application/json" \
-d '{
"input": "Compare recent vector database releases",
"model": "mini"
}'curl {{PUBLIC_API_BASE_URL}}/tools/tavily/research/job_example \
-H "Authorization: Bearer gw_live_..."job_id привязан к ключу API и рабочему пространству, где задача была создана. Чужой ключ получит 404.
Безопасность
Не передавайте api_key или похожие поля. Gateway добавляет серверные учётные данные сам и убирает служебные поля использования из публичного ответа.