Felo API PlatformFelo API Platform
Tüm Exa endpoint'leri
v0.2.0-beta
OpenAPI 3.1.0

Nöral anlamsal web araması çalıştırın.

Sunucu:https://openapi.felo.ai
İstemci Kitaplıkları

Exa

​

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

Nöral anlamsal web araması çalıştırın.

​

Web'de anahtar kelime yerine anlama göre arama yapın. query zorunludur; category, includeDomains, excludeDomains, startPublishedDate, endPublishedDate ile daraltın ve numResults ayarlayın. requestId, resolvedSearchType, searchTime, costDollars ve id, title, url içeren results[] döndürür. id URL'dir ve post_exa_contents bunu alır. ⚠️ Sonuçlar, siz istemedikçe sayfa metni içermez: contents geçirin veya post_exa_contents ile devam edin. Sorgu anahtar kelimeler değil de bir açıklama olduğunda bunu searchWeb yerine seçin; metni aynı çağrıda istiyorsanız Tavily'yi, liste yerine yazılı yanıt istiyorsanız post_exa_answer seçin.

Fiyatlandırma referansı

  • Ölçümlendirme: bildirilen yanıt maliyeti.
  • Referans istek tahmini: USD 0.017.
  • Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.

Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.

Gövde
gerekli
application/json
  • query
    Tür: string
    gerekli

    Doğal dilde arama sorgusu.

  • category
    Tür: string enum

    Önceliklendirilecek sayfa türü hakkında isteğe bağlı ipucu.

    değerler
    • company
    • research paper
    • news
    • personal site
    • financial report
    • people
  • contents
    Tür: object

    Her sonuçla birlikte döndürülecek içerik seçenekleri.

    • highlights
      Tür: boolean

      Vurgulanan ilgili snippet'leri döndür.

    • summary
      Tür: boolean

      Sayfanın AI tarafından oluşturulan özetini döndür.

    • text
      Tür: boolean

      Tam sayfa metnini döndür.

  • endPublishedDate
    Tür: string Biçim: date-time

    Yalnızca bu ISO 8601 tarihinde veya öncesinde yayımlanan sonuçları döndür.

  • excludeDomains
    Tür: array string[]

    Bu alan adlarındaki sonuçları hariç tut.

  • includeDomains
    Tür: array string[]

    Yalnızca bu alan adlarındaki sonuçları döndür.

  • numResults
    Tür: integer
    min:  
    1
    maks:  
    100

    Döndürülecek sonuç sayısı.

  • outputSchema
    Tür: object

    Sonuçlardan yapılandırılmış bir çıktı sentezlemek için kullanılan JSON Schema.

  • startPublishedDate
    Tür: string Biçim: date-time

    Yalnızca bu ISO 8601 tarihinde veya sonrasında yayımlanan sonuçları döndür.

  • stream
    Tür: boolean enum
    sabit:  
    false
    değerler
    • false
  • systemPrompt
    Tür: string

    Yapılandırılmış çıktının nasıl oluşturulacağını yönlendiren talimat.

  • type
    Tür: string enum

    Arama modu. auto, seçimi Exa'ya bırakır; deep modları daha yüksek kaliteli getirme karşılığında gecikmeyi artırır.

    değerler
    • auto
    • fast
    • instant
    • deep-lite
    • deep
    • deep-reasoning
Yanıtlar
  • 200
    Tür: object

    Arama başarıyla tamamlandı.

    • costDollars

      Kaynak kullanımı için sağlayıcı maliyet dökümü. Yalnızca bilgilendirme amaçlıdır; Felo müşteri ücreti veya Felo faturalandırma makbuzu değildir.

    • output

      Yapılandırılmış çıktı; yalnızca outputSchema sağlandığında bulunur.

    • requestId
      Tür: string

      Exa istek tanımlayıcısı.

    • results
      Tür: array object[]

      Sıralanmış arama sonuçları.

      • author
        Tür: string
      • id
        Tür: string
      • publishedDate
        Tür: string
      • title
        Tür: string
      • url
        Tür: string
    application/json
  • 400

    İstek işlenemedi. İstek parametrelerini kontrol edin.

  • 401

    Geçerli bir Felo API anahtarı gerekir.

  • 402

    Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.

  • 403

    Hesabın bu işlemi gerçekleştirme izni yok.

  • 429

    İstek veya harcama sınırına ulaşıldı.

  • 502

    Hizmet isteği tamamlayamadı.

  • 503

    API veya faturalandırma hizmeti geçici olarak kullanılamıyor.

  • 504

    İstek işlenirken hizmet zaman aşımına uğradı.

  • default

    Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir

    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.