Executar uma pesquisa semântica neural na web.
Exa
Semantic search, page content, cited answers and asynchronous research.
Executar uma pesquisa semântica neural na web.
Pesquisa a web por significado em vez de palavra-chave. query é obrigatório; restrinja com category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate e defina numResults. Retorna requestId, resolvedSearchType, searchTime, costDollars e results[] com id, title e url. id é a URL, e é o que post_exa_contents recebe. ⚠️ Os resultados não trazem texto da página a menos que você peça: passe contents ou faça o acompanhamento com post_exa_contents. Escolha-o em vez de searchWeb quando a consulta for uma descrição e não palavras-chave; escolha Tavily quando quiser o texto na mesma chamada, e post_exa_answer quando quiser uma resposta escrita em vez de uma lista.
Referência de preços
- Medição: Custo da resposta reportado.
- Estimativa de referência por requisição: USD 0.017.
- Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: stringqueryobrigatório
A consulta de pesquisa em linguagem natural.
- Tipo: string enumcategory
Dica opcional sobre o tipo de páginas a priorizar.
valores- company
- research paper
- news
- personal site
- financial report
- people
- Tipo: objectcontents
Opções de conteúdo a retornar junto com cada resultado.
- highlightsTipo: boolean
Retornar trechos relevantes destacados.
- summaryTipo: boolean
Retornar um resumo da página gerado por IA.
- textTipo: boolean
Retornar o texto completo da página.
- Tipo: string Formato: date-timeend
Published Date Retornar apenas resultados publicados nesta data ISO 8601 ou antes.
- Tipo: array string[]exclude
Domains Excluir resultados destes domínios.
- Tipo: array string[]include
Domains Retornar apenas resultados destes domínios.
- Tipo: integernum
Results mín:1máx:100Número de resultados a retornar.
- Tipo: objectoutput
Schema JSON Schema usado para sintetizar uma saída estruturada a partir dos resultados.
- Tipo: string Formato: date-timestart
Published Date Retornar apenas resultados publicados nesta data ISO 8601 ou depois.
- Tipo: boolean enumstreamconst:falsevalores
- false
- Tipo: stringsystem
Prompt Instrução que orienta como a saída estruturada é gerada.
- Tipo: string enumtype
Modo de pesquisa. auto deixa o Exa escolher; os modos deep trocam latência por recuperação de maior qualidade.
valores- auto
- fast
- instant
- deep
-lite - deep
- deep
-reasoning
- Tipo: object200
Pesquisa concluída com sucesso.
- cost
Dollars Detalhamento de custos do provedor para uso de recursos. Apenas informativo; não é a cobrança do cliente Felo nem um recibo de cobrança da Felo.
- output
Saída estruturada, presente apenas quando outputSchema foi fornecido.
- Tipo: stringrequest
Id Identificador de requisição do Exa.
- Tipo: array object[]results
Resultados de pesquisa classificados.
- authorTipo: string
- idTipo: string
- publishedTipo: string
Date - titleTipo: string
- urlTipo: string
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
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
}