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 همان نشانی است و همان چیزی است که 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
بازگرداندن خلاصه تولیدشده با AI از صفحه.
- 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
}