Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
Витягує читабельний вміст з одного URL або масиву URL. Виберіть текст або Markdown за допомогою format. Перевіряйте і results, і failed_results: URL з помилкою може бути вказано в інакше успішній HTTP-відповіді. Установіть include_usage, щоб отримувати відомості про використання ресурсів; usage.credits — це не списання Felo.
Довідкові ціни
- Тарифікація: тарифіковані одиниці відповіді.
- Довідкова оцінка запиту: USD 0.024.
- Базова вартість одиниці: USD 0.008.
- Одиниця ресурсу:
tavily_credit. - Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.
- Базові вартості не визначають остаточну ціну для клієнта, зокрема коли вони дорівнюють нулю.
Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.
- urlsобов'язкове
URL або URL-адреси, з яких потрібно вилучити вміст. Приймається як один рядок URL, так і масив рядків URL.
- Тип: string
URL або URL-адреси, з яких потрібно вилучити вміст. Приймається як один рядок URL, так і масив рядків URL.
- Тип: integerchunks
_per _source мін.:1макс.:5Максимальна кількість релевантних чанків, що повертаються на джерело. Доступно лише коли вказано query.
- Тип: string перелікextract
_depth Глибина процесу вилучення.
значення- basic
- advanced
- Тип: string перелікformat
Формат вилученого вмісту вебсторінки.
значення- markdown
- text
- Тип: booleaninclude
_favicon Включати URL favicon для кожного результату.
- Тип: booleaninclude
_images Включати список зображень, вилучених з URL.
- Тип: booleaninclude
_usage Включати відомості про використання ресурсів у відповідь. Це не інформація про білінг Felo.
- Тип: stringquery
Намір користувача для повторного ранжування вилучених чанків вмісту.
- Тип: number Формат: floattimeoutмін.:1макс.:60
Максимальний час очікування вилучення URL у секундах. Якщо пропущено, тайм-аути за замовчуванням залежать від extract_depth: 10 секунд для basic і 30 секунд для advanced.
- Тип: object200
Результати вилучення успішно повернено.
- Тип: array string[]failed
_results Список URL, які не вдалося обробити.
- Тип: stringrequest
_id Унікальний ідентифікатор запиту.
- Тип: number Формат: floatresponse
_time Час виконання запиту в секундах.
- Тип: array object[]results
- faviconТип: string | null
URL favicon вилученого вмісту.
- imagesТип: array string[]
Зображення, вилучені з URL, коли include_images має значення true.
- rawТип: string
_content Необроблений вміст, вилучений з URL.
- titleТип: string
Заголовок вилученої сторінки.
- urlТип: string
URL вилученого вмісту.
- Тип: objectusage
- creditsТип: integer
Одиниці ресурсів, витрачені цим запитом; не USD і не кредити Felo.
application/json - 400
Не вдалося обробити запит. Перевірте параметри запиту.
- 401
Потрібен дійсний API-ключ Felo.
- 402
Запит неможливо виконати: умови білінгу не виконано.
- 403
Обліковий запис не має дозволу на цю операцію.
- 429
Досягнуто ліміту запитів або витрат.
- 502
Служба не змогла виконати запит.
- 503
API або служба білінгу тимчасово недоступні.
- 504
Час очікування обробки запиту вичерпано.
- default
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}