Создаёт полные карты сайта с помощью Tavily Map.
Web Content
Web crawling, URL discovery and page extraction.
Создаёт полные карты сайта с помощью Tavily Map.
Перечисляет URL сайта от корневого url, не загружая содержимое страниц. Управляйте обходом с помощью instructions на естественном языке и фильтров select_paths / exclude_paths / select_domains на регулярных выражениях. Возвращает base_url и results — плоский массив строк URL, а не объектов — вместе с response_time и request_id. Используйте, чтобы оценить размер сайта перед обходом, а затем загрузите только нужные части через extractWebContent. Если нужно содержимое, а не структура, post_tavily_crawl делает и то и другое за один вызов.
Справочная информация о ценах
- Тарификация: тарифицируемые единицы ответа.
- Справочная оценка запроса: USD 0.064.
- Базовая стоимость единицы: USD 0.008.
- Единица ресурса:
tavily_credit. - Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
- Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю.
Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: stringurlобязательно
Корневой URL для начала сопоставления.
- Тип: booleanallow
_external Включать ссылки на внешние домены в итоговый список результатов.
- Тип: array string[]exclude
_domains Regex-шаблоны для исключения конкретных доменов или поддоменов из сопоставления.
- Тип: array string[]exclude
_paths Regex-шаблоны для исключения URL с определёнными шаблонами путей.
- Тип: booleaninclude
_usage Включать сведения об использовании кредитов в ответ.
- Тип: stringinstructions
Инструкции для краулера на естественном языке.
- Тип: integerlimitмин.:1
Общее количество ссылок, которые краулер обработает до остановки.
- Тип: integermax
_breadth мин.:1макс.:500Максимальное количество ссылок для перехода на каждом уровне дерева.
- Тип: integermax
_depth мин.:1макс.:5Максимальная глубина сопоставления.
- Тип: array string[]select
_domains Regex-шаблоны для выбора обхода только конкретных доменов или поддоменов.
- Тип: array string[]select
_paths Regex-шаблоны для выбора только URL с определёнными шаблонами путей.
- Тип: number Формат: floattimeoutмин.:10макс.:150
Максимальное время ожидания операции map в секундах.
- Тип: object200
Результаты карты успешно возвращены.
- Тип: stringbase
_url Базовый URL, который был сопоставлен.
- Тип: stringrequest
_id Уникальный идентификатор запроса.
- Тип: number Формат: floatresponse
_time Время выполнения запроса в секундах.
- Тип: array string[]results
- Тип: objectusage
- creditsТип: integer
Сведения об использовании кредитов для запроса.
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/tavily/map \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"url": "docs.tavily.com",
"instructions": "",
"max_depth": 1,
"max_breadth": 20,
"limit": 50,
"select_paths": [
""
],
"select_domains": [
""
],
"exclude_paths": [
""
],
"exclude_domains": [
""
],
"allow_external": true,
"timeout": 150,
"include_usage": false
}'
{
"base_url": "string",
"results": [
"string"
],
"response_time": 1,
"usage": {
"credits": 1
},
"request_id": "string"
}