Felo API PlatformFelo API Platform
Alle endpoints van Exa
v0.2.0-beta
OpenAPI 3.1.0

Een neurale semantische webzoekopdracht uitvoeren.

Server:https://openapi.felo.ai
Clientbibliotheken

Exa

​

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

Een neurale semantische webzoekopdracht uitvoeren.

​

Doorzoekt het web op betekenis in plaats van op trefwoord. query is vereist; verfijn met category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate en stel numResults in. Retourneert requestId, resolvedSearchType, searchTime, costDollars en results[] met id, title en url. id is de URL, en dat is wat post_exa_contents verwacht. ⚠️ Resultaten bevatten geen paginatekst tenzij je erom vraagt: geef contents mee, of volg op met post_exa_contents. Kies dit boven searchWeb wanneer de query een beschrijving is in plaats van trefwoorden; kies Tavily wanneer je de tekst in dezelfde aanroep wilt, en post_exa_answer wanneer je een geschreven antwoord wilt in plaats van een lijst.

Prijsreferentie

  • Metering: Gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.017.
  • Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
verplicht
application/json
  • query
    Type: string
    verplicht

    De zoekopdracht in natuurlijke taal.

  • category
    Type: string enum

    Optionele hint over het soort pagina's dat prioriteit moet krijgen.

    waarden
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Type: object

    Inhoudsopties die bij elk resultaat moeten worden geretourneerd.

    • highlights
      Type: boolean

      Gemarkeerde relevante snippets retourneren.

    • summary
      Type: boolean

      Een door AI gegenereerde samenvatting van de pagina retourneren.

    • text
      Type: boolean

      De volledige paginatekst retourneren.

  • endPublishedDate
    Type: string Formaat: date-time

    Alleen resultaten retourneren die op of vóór deze ISO 8601-datum zijn gepubliceerd.

  • excludeDomains
    Type: array string[]

    Resultaten van deze domeinen uitsluiten.

  • includeDomains
    Type: array string[]

    Alleen resultaten van deze domeinen retourneren.

  • numResults
    Type: integer
    min.:  
    1
    max.:  
    100

    Aantal resultaten dat moet worden geretourneerd.

  • outputSchema
    Type: object

    JSON Schema dat wordt gebruikt om een gestructureerde uitvoer uit de resultaten samen te stellen.

  • startPublishedDate
    Type: string Formaat: date-time

    Alleen resultaten retourneren die op of na deze ISO 8601-datum zijn gepubliceerd.

  • stream
    Type: boolean enum
    constante:  
    false
    waarden
    • false
  • systemPrompt
    Type: string

    Instructie die bepaalt hoe de gestructureerde uitvoer wordt gegenereerd.

  • type
    Type: string enum

    Zoekmodus. auto laat Exa kiezen; de deep-modi ruilen latentie voor hogere ophaalkwaliteit.

    waarden
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Responsen
  • 200
    Type: object

    Zoeken succesvol voltooid.

    • costDollars

      Kostenoverzicht van de provider voor resourcegebruik. Alleen ter informatie; niet de klantkosten van Felo en geen Felo-factureringsbewijs.

    • output

      Gestructureerde uitvoer, alleen aanwezig wanneer outputSchema is opgegeven.

    • requestId
      Type: string

      Exa-verzoekidentificatie.

    • results
      Type: array object[]

      Gerangschikte zoekresultaten.

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

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

    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.