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 نیست.
مرجع قیمت‌گذاری
- اندازه‌گیری: واحدهای پاسخ اندازه‌گیری‌شده.
- برآورد درخواست مرجع: 0.024 دلار آمریکا.
- مبنای هزینه واحد: 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 فاوآیکون برای هر نتیجه.
- نوع: 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 فاوآیکون محتوای استخراج‌شده.
- imagesنوع: array string[]
تصاویر استخراج‌شده از URL وقتی include_images برابر true است.
- rawنوع: string
_content محتوای خام استخراج‌شده از URL.
- titleنوع: string
عنوان صفحه استخراج‌شده.
- urlنوع: string
URL محتوای استخراج‌شده.
- نوع: objectusage
- creditsنوع: integer
واحدهای منابع مصرف‌شده توسط این درخواست، نه دلار آمریکایی یا اعتبارهای 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"
}