Web Search
Search public web content with Tavily.
Tavily Search
ابحث في الويب وأعد نتائج مرتّبة مع العناوين وعناوين URL ومقتطفات المحتوى. query مطلوب. استخدم max_results للتحكم في عدد النتائج وsearch_depth لاختيار وضع البحث. لا تُعاد answer وimages وraw content الإضافية إلا عند طلبها. اضبط include_usage لتلقي معلومات استخدام الموارد؛ usage.credits ليست رسومًا من Felo.
مرجع التسعير
- القياس: وحدات الاستجابة المقيسة.
- تقدير الطلب المرجعي: 0.016 دولار أمريكي.
- أساس تكلفة الوحدة: 0.008 دولار أمريكي.
- وحدة المورد:
tavily_credit. - مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
- لا تحدد أسس التكلفة السعر النهائي للعميل، بما في ذلك عندما تكون صفرًا.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringqueryمطلوب
استعلام البحث المراد تنفيذه باستخدام Tavily.
- النوع: booleanauto
_parameters تكوين معاملات البحث تلقائيًا بناءً على محتوى الاستعلام.
- النوع: integerchunks
_per _source الحد الأدنى:1الحد الأقصى:3الحد الأقصى لعدد المقاطع ذات الصلة المعادة لكل مصدر.
- النوع: string تعدادcountry
تعزيز نتائج البحث من بلد محدد. متاح فقط عندما تكون topic هي general.
القيم- afghanistan
- albania
- algeria
- andorra
- angola
- النوع: string التنسيق: dateend
_date إرجاع النتائج قبل تاريخ الانتهاء المحدد.
- النوع: array string[] …150exclude
_domains قائمة النطاقات المراد استبعادها تحديدًا من نتائج البحث.
- include
_answer تضمين إجابة مولّدة بواسطة LLM. true تستخدم وضع الإجابة الافتراضي؛ basic أو advanced تحدد وضع توليد الإجابة.
- النوع: boolean
تضمين إجابة مولّدة بواسطة LLM. true تستخدم وضع الإجابة الافتراضي؛ basic أو advanced تحدد وضع توليد الإجابة.
- النوع: array string[] …300include
_domains قائمة النطاقات المراد تضمينها تحديدًا في نتائج البحث.
- النوع: booleaninclude
_favicon تضمين عنوان URL لأيقونة الموقع لكل نتيجة.
- النوع: booleaninclude
_image _descriptions إضافة نص وصفي لكل صورة عندما تكون include_images هي true.
- النوع: booleaninclude
_images إجراء بحث عن الصور وتضمين النتائج.
- include
_raw _content تضمين محتوى منظّف ومُحلَّل لكل نتيجة بحث. true أو markdown يعيدان markdown؛ وtext يعيد نصًا عاديًا وقد يزيد زمن الاستجابة.
- النوع: boolean
تضمين محتوى منظّف ومُحلَّل لكل نتيجة بحث. true أو markdown يعيدان markdown؛ وtext يعيد نصًا عاديًا وقد يزيد زمن الاستجابة.
- النوع: booleaninclude
_usage تضمين معلومات استخدام الموارد في الاستجابة. هذه ليست معلومات فوترة Felo.
- النوع: integermax
_results الحد الأدنى:0الحد الأقصى:20الحد الأقصى لعدد نتائج البحث المراد إرجاعها.
- النوع: booleansafe
_search استبعاد المحتوى للبالغين أو غير الآمن من نتائج البحث. للمؤسسات فقط؛ غير مدعوم عندما تكون search_depth هي fast أو ultra-fast.
- النوع: string تعدادsearch
_depth يتحكم في المقايضة بين زمن الاستجابة والصلة. يمنح advanced أعلى صلة بزمن استجابة وتكلفة أعلى؛ وbasic متوازن؛ ويحسّن fast وultra-fast زمن استجابة أقل.
القيم- advanced
- basic
- fast
- ultra
-fast
- النوع: string التنسيق: datestart
_date إرجاع النتائج بعد تاريخ البدء المحدد.
- النوع: string تعدادtime
_range النطاق الزمني لتصفية النتائج بناءً على تاريخ النشر.
القيم- day
- week
- month
- year
- d
- w
- m
- y
- النوع: string تعدادtopic
فئة البحث.
القيم- general
- news
- finance
- النوع: object200
أُعيدت نتائج البحث بنجاح.
- النوع: string | nullanswer
إجابة قصيرة مولّدة بواسطة LLM. تظهر كـ null عندما تكون include_answer هي false أو لم تُولَّد إجابة.
- النوع: array object[]images
- descriptionالنوع: string
وصف الصورة.
- urlالنوع: string
عنوان URL للصورة.
- النوع: stringquery
استعلام البحث الذي جرى تنفيذه.
- النوع: stringrequest
_id معرّف فريد للطلب.
- النوع: number التنسيق: floatresponse
_time الوقت بالثواني المستغرق لإكمال الطلب.
- النوع: array object[]results
- contentالنوع: string
مقتطف محتوى نتيجة البحث.
- faviconالنوع: string | null
عنوان URL لأيقونة الموقع لنتيجة البحث.
- rawالنوع: string | null
_content المحتوى المصدر المنظّف والمُحلَّل. Null إلا إذا طُلب include_raw_content أو لم يتوفر محتوى خام.
- scoreالنوع: number التنسيق: float
درجة الصلة لنتيجة البحث.
- 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/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}