Felo API PlatformFelo API Platform
Semua endpoint Exa
v0.2.0-beta
OpenAPI 3.1.0

Jalankan pencarian web semantik neural.

Server:https://openapi.felo.ai
Pustaka Klien

Exa

​

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

Jalankan pencarian web semantik neural.

​

Cari di web berdasarkan makna, bukan kata kunci. query wajib; persempit dengan category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate, dan atur numResults. Mengembalikan requestId, resolvedSearchType, searchTime, costDollars, dan results[] dengan id, title, dan url. id adalah URL, dan itulah yang diterima post_exa_contents. ⚠️ Hasil tidak membawa teks halaman kecuali Anda memintanya: teruskan contents, atau lanjutkan dengan post_exa_contents. Pilih ini alih-alih searchWeb bila kueri berupa deskripsi, bukan kata kunci; pilih Tavily bila Anda ingin teks dalam panggilan yang sama, dan post_exa_answer bila Anda ingin jawaban tertulis, bukan daftar.

Referensi harga

  • Metering: Biaya respons yang dilaporkan.
  • Estimasi referensi per permintaan: USD 0.017.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
wajib
application/json
  • query
    Tipe: string
    wajib

    Kueri pencarian bahasa alami.

  • category
    Tipe: string enum

    Petunjuk opsional tentang jenis halaman yang diprioritaskan.

    nilai
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Tipe: object

    Opsi konten yang dikembalikan bersama setiap hasil.

    • highlights
      Tipe: boolean

      Kembalikan cuplikan relevan yang disorot.

    • summary
      Tipe: boolean

      Kembalikan ringkasan halaman yang dihasilkan AI.

    • text
      Tipe: boolean

      Kembalikan teks halaman lengkap.

  • endPublishedDate
    Tipe: string Format: date-time

    Hanya kembalikan hasil yang diterbitkan pada atau sebelum tanggal ISO 8601 ini.

  • excludeDomains
    Tipe: array string[]

    Kecualikan hasil dari domain ini.

  • includeDomains
    Tipe: array string[]

    Hanya kembalikan hasil dari domain ini.

  • numResults
    Tipe: integer
    min:  
    1
    maks:  
    100

    Jumlah hasil yang akan dikembalikan.

  • outputSchema
    Tipe: object

    JSON Schema yang digunakan untuk menyusun output terstruktur dari hasil.

  • startPublishedDate
    Tipe: string Format: date-time

    Hanya kembalikan hasil yang diterbitkan pada atau setelah tanggal ISO 8601 ini.

  • stream
    Tipe: boolean enum
    const:  
    false
    nilai
    • false
  • systemPrompt
    Tipe: string

    Instruksi yang memandu cara output terstruktur dihasilkan.

  • type
    Tipe: string enum

    Mode pencarian. auto membiarkan Exa memilih; mode deep menukar latensi dengan pengambilan berkualitas lebih tinggi.

    nilai
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Respons
  • 200
    Tipe: object

    Pencarian berhasil.

    • costDollars

      Rincian biaya penyedia untuk penggunaan sumber daya. Hanya informasi; bukan biaya pelanggan Felo atau tanda terima tagihan Felo.

    • output

      Output terstruktur, hanya ada ketika outputSchema disediakan.

    • requestId
      Tipe: string

      Pengenal permintaan Exa.

    • results
      Tipe: array object[]

      Hasil pencarian berperingkat.

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

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

    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.