Exa
Semantic search, page content, cited answers and asynchronous research.
تشغيل بحث ويب دلالي عصبي.
ابحث في الويب بالمعنى بدلًا من الكلمات المفتاحية. query مطلوب؛ ضيّق النطاق بـ category وincludeDomains وexcludeDomains وstartPublishedDate وendPublishedDate، واضبط numResults. يعيد requestId وresolvedSearchType وsearchTime وcostDollars وresults[] مع id وtitle وurl. id هو عنوان URL، وهو ما تأخذه post_exa_contents. ⚠️ لا تحمل النتائج نصًا للصفحة ما لم تطلبه: مرّر contents، أو تابع بـ post_exa_contents. اختره بدلًا من searchWeb عندما يكون الاستعلام وصفًا لا كلمات مفتاحية؛ واختر Tavily عندما تريد النص في الاستدعاء نفسه، وpost_exa_answer عندما تريد إجابة مكتوبة لا قائمة.
مرجع التسعير
- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.017 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.
بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringqueryمطلوب
استعلام البحث باللغة الطبيعية.
- النوع: string تعدادcategory
تلميح اختياري حول نوع الصفحات المراد إعطاؤها أولوية.
القيم- company
- research paper
- news
- personal site
- financial report
- people
- النوع: objectcontents
خيارات المحتوى المراد إرجاعها مع كل نتيجة.
- highlightsالنوع: boolean
إرجاع مقتطفات ذات صلة ومميّزة.
- summaryالنوع: boolean
إرجاع ملخّص للصفحة مولّد بالذكاء الاصطناعي.
- textالنوع: boolean
إرجاع النص الكامل للصفحة.
- النوع: string التنسيق: date-timeend
Published Date إرجاع النتائج المنشورة في هذا التاريخ بتنسيق ISO 8601 أو قبله فقط.
- النوع: array string[]exclude
Domains استبعاد النتائج من هذه النطاقات.
- النوع: array string[]include
Domains إرجاع النتائج من هذه النطاقات فقط.
- النوع: integernum
Results الحد الأدنى:1الحد الأقصى:100عدد النتائج المراد إرجاعها.
- النوع: objectoutput
Schema مخطط JSON يُستخدم لتركيب إخراج منظّم من النتائج.
- النوع: string التنسيق: date-timestart
Published Date إرجاع النتائج المنشورة في هذا التاريخ بتنسيق ISO 8601 أو بعده فقط.
- النوع: boolean تعدادstreamثابت:falseالقيم
- false
- النوع: stringsystem
Prompt تعليمات توجّه كيفية توليد الإخراج المنظّم.
- النوع: string تعدادtype
وضع البحث. يتيح auto لـExa الاختيار؛ وتقايض الأوضاع deep زمن الاستجابة بجودة استرجاع أعلى.
القيم- auto
- fast
- instant
- deep
-lite - deep
- deep
-reasoning
- النوع: object200
تم البحث بنجاح.
- cost
Dollars تفصيل تكلفة المزوّد لاستخدام الموارد. للعلم فقط؛ وليس رسوم عميل Felo أو إيصال فوترة من Felo.
- output
إخراج منظّم، يظهر فقط عند توفير outputSchema.
- النوع: stringrequest
Id معرّف طلب Exa.
- النوع: array object[]results
نتائج بحث مرتّبة.
- authorالنوع: string
- idالنوع: string
- publishedالنوع: string
Date - titleالنوع: string
- urlالنوع: string
application/json - 400
تعذّرت معالجة الطلب. تحقق من معاملات الطلب.
- 401
مطلوب مفتاح API صالح من Felo.
- 402
لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.
- 403
الحساب غير مصرّح له بهذه العملية.
- 429
تم بلوغ حد الطلبات أو حد الإنفاق.
- 502
تعذّر على الخدمة إكمال الطلب.
- 503
خدمة API أو الفوترة غير متاحة مؤقتًا.
- 504
انتهت مهلة الخدمة أثناء معالجة الطلب.
- default
استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد
application/json
curl https://openapi.felo.ai/v1/beta/exa/search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"query": "latest evaluation frameworks for AI agents",
"type": "auto",
"numResults": 10,
"category": "company",
"includeDomains": [
""
],
"excludeDomains": [
""
],
"startPublishedDate": "",
"endPublishedDate": "",
"contents": {
"text": true,
"highlights": true,
"summary": true
},
"outputSchema": {},
"systemPrompt": "",
"stream": false
}'
{
"requestId": "string",
"results": [
{
"title": "string",
"url": "string",
"publishedDate": "string",
"author": "string",
"id": "string"
}
],
"output": null,
"costDollars": null
}