Web Content
Web crawling, URL discovery and page extraction.
Tavily Extract
استخرج محتوى قابلًا للقراءة من عنوان URL واحد أو من مصفوفة عناوين. اختر النص أو Markdown عبر format. افحص results وfailed_results معًا: فقد يُبلَّغ عن عنوان فاشل داخل استجابة 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 لأيقونة الموقع (favicon) للمحتوى المستخرج.
- 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"
}