Створює повні карти сайту за допомогою 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
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
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"
}