Web Search
Search public web content with Tavily.
Tavily Araması
Web'de arama yapar ve başlıklar, URL'ler ve içerik parçacıkları içeren sıralanmış sonuçlar döndürür. query zorunludur. Sonuç sayısını kontrol etmek için max_results, arama modunu seçmek için search_depth kullanın. Ek answer, images ve ham içerik yalnızca istendiğinde döndürülür. Kaynak kullanım bilgilerini almak için include_usage değerini ayarlayın; usage.credits bir Felo ücreti değildir.
Fiyatlandırma referansı
- Ölçümlendirme: ölçümlendirilen yanıt birimleri.
- Referans istek tahmini: USD 0.016.
- Birim maliyet esası: USD 0.008.
- Kaynak birimi:
tavily_credit. - Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
- Maliyet esasları, sıfır olduğunda dahi nihai müşteri fiyatını belirlemez.
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.
- Tür: stringquerygerekli
Tavily ile yürütülecek arama sorgusu.
- Tür: booleanauto
_parameters Arama parametrelerini sorgu içeriğine göre otomatik olarak yapılandırın.
- Tür: integerchunks
_per _source min:1maks:3Kaynak başına döndürülen maksimum ilgili parça sayısı.
- Tür: string enumcountry
Belirli bir ülkeden gelen arama sonuçlarını öne çıkarın. Yalnızca topic general olduğunda kullanılabilir.
değerler- afghanistan
- albania
- algeria
- andorra
- angola
- Tür: string Biçim: dateend
_date Belirtilen bitiş tarihinden önceki sonuçları döndürün.
- Tür: array string[] …150exclude
_domains Arama sonuçlarından özellikle hariç tutulacak alan adları listesi.
- include
_answer LLM tarafından oluşturulan bir yanıt ekleyin. true varsayılan yanıt modunu kullanır; basic veya advanced yanıt oluşturma modunu seçer.
- Tür: boolean
LLM tarafından oluşturulan bir yanıt ekleyin. true varsayılan yanıt modunu kullanır; basic veya advanced yanıt oluşturma modunu seçer.
- Tür: array string[] …300include
_domains Arama sonuçlarına özellikle dahil edilecek alan adları listesi.
- Tür: booleaninclude
_favicon Her sonuç için favicon URL'sini ekleyin.
- Tür: booleaninclude
_image _descriptions include_images true olduğunda her görsel için açıklayıcı metin ekleyin.
- Tür: booleaninclude
_images Görsel araması yapın ve sonuçları dahil edin.
- include
_raw _content Her arama sonucu için temizlenmiş ve ayrıştırılmış içerik ekleyin. true veya markdown markdown döndürür; text düz metin döndürür ve gecikmeyi artırabilir.
- Tür: boolean
Her arama sonucu için temizlenmiş ve ayrıştırılmış içerik ekleyin. true veya markdown markdown döndürür; text düz metin döndürür ve gecikmeyi artırabilir.
- Tür: booleaninclude
_usage Yanıta kaynak kullanım bilgilerini dahil edin. Bu, Felo faturalandırma bilgisi değildir.
- Tür: integermax
_results min:0maks:20Döndürülecek maksimum arama sonucu sayısı.
- Tür: booleansafe
_search Yetişkinlere yönelik veya güvenli olmayan içerikleri arama sonuçlarından filtreleyin. Yalnızca Enterprise; search_depth fast veya ultra-fast olduğunda desteklenmez.
- Tür: string enumsearch
_depth Gecikme ile alaka düzeyi arasındaki dengeyi kontrol eder. advanced, daha yüksek gecikme ve maliyetle en yüksek alaka düzeyini sunar; basic dengelidir; fast ve ultra-fast daha düşük gecikme için optimize eder.
değerler- advanced
- basic
- fast
- ultra
-fast
- Tür: string Biçim: datestart
_date Belirtilen başlangıç tarihinden sonraki sonuçları döndürün.
- Tür: string enumtime
_range Sonuçları yayın tarihine göre filtrelemek için zaman aralığı.
değerler- day
- week
- month
- year
- d
- w
- m
- y
- Tür: string enumtopic
Aramanın kategorisi.
değerler- general
- news
- finance
- Tür: object200
Arama sonuçları başarıyla döndürüldü.
- Tür: string | nullanswer
Kısa, LLM tarafından oluşturulan yanıt. include_answer false olduğunda veya yanıt oluşturulmadığında null olarak bulunur.
- Tür: array object[]images
- descriptionTür: string
Görsel açıklaması.
- urlTür: string
Görsel URL'si.
- Tür: stringquery
Yürütülen arama sorgusu.
- Tür: stringrequest
_id Benzersiz istek tanımlayıcısı.
- Tür: number Biçim: floatresponse
_time İsteğin tamamlanmasının aldığı süre (saniye).
- Tür: array object[]results
- contentTür: string
Arama sonucunun içerik parçası.
- faviconTür: string | null
Arama sonucunun favicon URL'si.
- rawTür: string | null
_content Temizlenmiş ve ayrıştırılmış kaynak içeriği. include_raw_content istenmediğinde veya ham içerik mevcut olmadığında null.
- scoreTür: number Biçim: float
Arama sonucunun alaka puanı.
- titleTür: string
Arama sonucunun başlığı.
- urlTür: string
Arama sonucunun URL'si.
- Tür: objectusage
- creditsTür: integer
Bu istek tarafından tüketilen kaynak birimleri; USD veya Felo kredisi değil.
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
curl --request POST https://openapi.felo.ai/v1/beta/tavily/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}