데이터 API / Exa / Search

Run a neural semantic web search.

Search the web by meaning rather than by keyword. query is required; narrow with category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate, and set numResults. Returns requestId, resolvedSearchType, searchTime, costDollars and results[] with id, title and url. id is the URL, and it is what post_exa_contents takes. ⚠️ Results carry no page text unless you ask: pass contents, or follow up with post_exa_contents. Choose it over searchWeb when the query is a description rather than keywords; choose Tavily when you want the text in the same call, and post_exa_answer when you want a written answer rather than a list.

파라미터

경로, 쿼리, 헤더 파라미터가 없습니다.

요청 본문

querystring필수
The natural-language search query.
typestring선택
허용 값: auto · fast · instant · deep-lite · deep · deep-reasoning
Search mode. auto lets Exa choose; the deep modes trade latency for higher-quality retrieval.
numResultsinteger선택
Number of results to return.
categorystring선택
허용 값: company · research paper · news · personal site · financial report · people
Optional hint about the kind of pages to prioritize.
includeDomainsstring[]선택
Only return results from these domains.
excludeDomainsstring[]선택
Exclude results from these domains.
startPublishedDatestring선택
Only return results published on or after this ISO 8601 date.
endPublishedDatestring선택
Only return results published on or before this ISO 8601 date.
contentsobject선택
Content options to return alongside each result.
textboolean선택
Return the full page text.
highlightsboolean선택
Return highlighted relevant snippets.
summaryboolean선택
Return an AI-generated summary of the page.
outputSchemaobject선택
JSON Schema used to synthesize a structured output from the results.
systemPromptstring선택
Instruction that guides how the structured output is generated.

요청 예시

curl -X POST "https://openapi.felo.ai/v1/beta/exa/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "<string>",
  "type": "<string>",
  "numResults": 0,
  "category": "<string>",
  "includeDomains": [
    "<string>"
  ],
  "excludeDomains": [
    "<string>"
  ],
  "startPublishedDate": "<string>",
  "endPublishedDate": "<string>"
}'

응답

응답 필드

requestIdstring선택
Exa request identifier.
resultsobject[]선택
Ranked search results.
titlestring선택
urlstring선택
publishedDatestring선택
authorstring선택
idstring선택
output선택
Structured output, present only when outputSchema was supplied.
costDollars선택
Upstream Exa cost breakdown. Informational only; customer billing is the flat $0.08.