Exa
Semantic search, page content, cited answers and asynchronous research.
執行神經網路語意搜尋。
依語意而非關鍵字搜尋網路。query 為必填；可透過 category、includeDomains、excludeDomains、startPublishedDate、endPublishedDate 縮小範圍，並設定 numResults。傳回 requestId、resolvedSearchType、searchTime、costDollars 以及包含 id、title 與 url 的 results[]。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
傳回頁面由 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 Schema。
- 類型: 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
需要有效的 Felo API 金鑰。
- 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
}