Felo API PlatformFelo API Platform
Alle Endpoints von Exa
v0.2.0-beta
OpenAPI 3.1.0

Eine neuronale semantische Websuche ausführen.

Server:https://openapi.felo.ai
Client-Bibliotheken

Exa

​

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

Eine neuronale semantische Websuche ausführen.

​

Durchsucht das Web nach Bedeutung statt nach Stichwort. query ist erforderlich; grenzen Sie mit category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate ein und setzen Sie numResults. Liefert requestId, resolvedSearchType, searchTime, costDollars und results[] mit id, title und url. id ist die URL und genau das, was post_exa_contents entgegennimmt. ⚠️ Ergebnisse enthalten keinen Seitentext, sofern Sie ihn nicht anfordern: Übergeben Sie contents oder rufen Sie anschließend post_exa_contents auf. Wählen Sie es gegenüber searchWeb, wenn die Abfrage eine Beschreibung statt Stichwörter ist; wählen Sie Tavily, wenn Sie den Text im selben Aufruf wollen, und post_exa_answer, wenn Sie eine geschriebene Antwort statt einer Liste wollen.

Preisreferenz

  • Abrechnung: Gemeldete Antwortkosten.
  • Referenzschätzung pro Anfrage: USD 0.017.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body
erforderlich
application/json
  • query
    Typ: string
    erforderlich

    Die natürlichsprachliche Suchabfrage.

  • category
    Typ: string enum

    Optionaler Hinweis zur Art der zu priorisierenden Seiten.

    Werte
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Typ: object

    Inhaltsoptionen, die mit jedem Ergebnis zurückgegeben werden sollen.

    • highlights
      Typ: boolean

      Hervorgehobene relevante Snippets zurückgeben.

    • summary
      Typ: boolean

      Eine KI-generierte Zusammenfassung der Seite zurückgeben.

    • text
      Typ: boolean

      Den vollständigen Seitentext zurückgeben.

  • endPublishedDate
    Typ: string Format: date-time

    Nur Ergebnisse zurückgeben, die an oder vor diesem ISO-8601-Datum veröffentlicht wurden.

  • excludeDomains
    Typ: array string[]

    Ergebnisse dieser Domains ausschließen.

  • includeDomains
    Typ: array string[]

    Nur Ergebnisse dieser Domains zurückgeben.

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

    Anzahl der zurückzugebenden Ergebnisse.

  • outputSchema
    Typ: object

    JSON-Schema, mit dem aus den Ergebnissen eine strukturierte Ausgabe erzeugt wird.

  • startPublishedDate
    Typ: string Format: date-time

    Nur Ergebnisse zurückgeben, die an oder nach diesem ISO-8601-Datum veröffentlicht wurden.

  • stream
    Typ: boolean enum
    Konstante:  
    false
    Werte
    • false
  • systemPrompt
    Typ: string

    Anweisung, die steuert, wie die strukturierte Ausgabe generiert wird.

  • type
    Typ: string enum

    Suchmodus. auto lässt Exa wählen; die Deep-Modi erkaufen höhere Abrufqualität mit Latenz.

    Werte
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Antworten
  • 200
    Typ: object

    Suche erfolgreich abgeschlossen.

    • costDollars

      Kostenaufschlüsselung des Anbieters für die Ressourcennutzung. Nur informativ; nicht die Kundenbelastung durch Felo und kein Felo-Abrechnungsbeleg.

    • output

      Strukturierte Ausgabe, nur vorhanden, wenn outputSchema angegeben wurde.

    • requestId
      Typ: string

      Exa-Anfrage-ID.

    • results
      Typ: array object[]

      Sortierte Suchergebnisse.

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

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

    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.