Felo API PlatformFelo API Platform
Tutti gli endpoint di Exa
v0.2.0-beta
OpenAPI 3.1.0

Esegui una ricerca web semantica neurale.

Server:https://openapi.felo.ai
Librerie client

Exa

​

Semantic search, page content, cited answers and asynchronous research.

Esegui una ricerca web semantica neurale.

​

Cerca sul web per significato anziché per parola chiave. query è obbligatorio; restringi con category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate e imposta numResults. Restituisce requestId, resolvedSearchType, searchTime, costDollars e results[] con id, title e url. id è l'URL, ed è ciò che accetta post_exa_contents. ⚠️ I risultati non contengono testo di pagina a meno che tu non lo chieda: passa contents oppure prosegui con post_exa_contents. Sceglilo al posto di searchWeb quando la query è una descrizione anziché parole chiave; scegli Tavily quando vuoi il testo nella stessa chiamata, e post_exa_answer quando vuoi una risposta scritta anziché un elenco.

Riferimento prezzi

  • Misurazione: costo della risposta comunicato.
  • Stima di riferimento per richiesta: USD 0.017.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo
obbligatorio
application/json
  • query
    Tipo: string
    obbligatorio

    La query di ricerca in linguaggio naturale.

  • category
    Tipo: string enum

    Suggerimento facoltativo sul tipo di pagine da prioritizzare.

    valori
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Tipo: object

    Opzioni di contenuto da restituire insieme a ogni risultato.

    • highlights
      Tipo: boolean

      Restituisci snippet pertinenti evidenziati.

    • summary
      Tipo: boolean

      Restituisci un riepilogo della pagina generato dall'IA.

    • text
      Tipo: boolean

      Restituisci il testo completo della pagina.

  • endPublishedDate
    Tipo: string Formato: date-time

    Restituisci solo i risultati pubblicati in data pari o precedente a questa data ISO 8601.

  • excludeDomains
    Tipo: array string[]

    Escludi i risultati da questi domini.

  • includeDomains
    Tipo: array string[]

    Restituisci solo i risultati da questi domini.

  • numResults
    Tipo: integer
    min:  
    1
    max:  
    100

    Numero di risultati da restituire.

  • outputSchema
    Tipo: object

    JSON Schema usato per sintetizzare un output strutturato dai risultati.

  • startPublishedDate
    Tipo: string Formato: date-time

    Restituisci solo i risultati pubblicati in data pari o successiva a questa data ISO 8601.

  • stream
    Tipo: boolean enum
    const:  
    false
    valori
    • false
  • systemPrompt
    Tipo: string

    Istruzione che guida la generazione dell'output strutturato.

  • type
    Tipo: string enum

    Modalità di ricerca. auto lascia scegliere a Exa; le modalità deep scambiano latenza con un recupero di qualità superiore.

    valori
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Risposte
  • 200
    Tipo: object

    Ricerca completata correttamente.

    • costDollars

      Dettaglio dei costi del provider per l'utilizzo delle risorse. Solo a scopo informativo; non è l'addebito al cliente Felo né una ricevuta di fatturazione Felo.

    • output

      Output strutturato, presente solo quando è stato fornito outputSchema.

    • requestId
      Tipo: string

      Identificatore della richiesta Exa.

    • results
      Tipo: array object[]

      Risultati di ricerca classificati.

      • author
        Tipo: string
      • id
        Tipo: string
      • publishedDate
        Tipo: string
      • title
        Tipo: string
      • url
        Tipo: string
    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    application/json
Request Example for post/v1/beta/exa/search
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
}
Run a neural semantic web search.