AI odaklı gerçek zamanlı web araması.
BytePlus
Web search and page content retrieval.
AI odaklı gerçek zamanlı web araması.
AI ajanları için tasarlanmış gerçek zamanlı bir web araması çalıştırır ve başlıklı, bağlantılı ve parçacıklı sıralı bir sonuç listesi döndürür. Query zorunludur; sonuç kümesini Count (≤ 20), Filter (Sites ile sınırla veya BlockHosts hariç tut), Language ve TimeRange ile daraltın. Yanıt, ResponseMetadata.RequestId ile web sonuçlarından oluşan bir Result listesini sarar. RAG getirim artırımı, rakip/PR izleme, olgu doğrulama ve içerik kaynaklama için kullanın; tam sayfa içeriğini çekmek için her sonuç URL'sini post_byteplus_fetch ile eşleştirin.
Fiyatlandırma referansı
- Ölçümlendirme: başarılı istek başına sabit maliyet esası.
- Referans istek tahmini: USD 0.0048.
- 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.
- Tür: stringQuerymaksimum uzunluk:400gerekli
Arama sorgusu. Zorunludur. En fazla 400 karakter; üst kaynak motoru ayrıca yaklaşık 50 kelimeyle etkin biçimde sınırlar.
- Tür: integerCountmaks:20
Döndürülecek sonuç sayısı. İsteğe bağlı; varsayılan 10, en fazla 20.
- Tür: objectFilter
İsteğe bağlı sonuç filtresi. Her iki alan da dikey çizgiyle ayrılmış tam alan adı dizeleridir (her birinde en fazla 5).
- BlockTür: string
Hosts Sonuçları bu tam alan adlarından hariç tutar. Dikey çizgiyle ayrılır, en fazla 5, örn. "reddit.com|quora.com".
- SitesTür: string
Sonuçları bu tam alan adlarıyla sınırlar. Dikey çizgiyle ayrılır, en fazla 5, örn. "bytedance.com|byteplus.com". (Dizi gönderilmesi 10400 Invalid Parameter döndürür.)
- Tür: stringLanguage
Üst kaynak biçiminde isteğe bağlı dil ipucu, örn. EN, ZH-HANS, ZH-HANT.
- Time
Range İsteğe bağlı güncellik aralığı. Adlandırılmış aralıklardan biri (OneDay / OneWeek / OneMonth / OneYear) veya özel bir aralık "YYYY-MM-DD..YYYY-MM-DD". Zaman filtresi istemiyorsanız atlayın. NOT: "week"/"month" gibi değerler üst kaynakta sessizce yok sayılır.
- Tür: string enum
İsteğe bağlı güncellik aralığı. Adlandırılmış aralıklardan biri (OneDay / OneWeek / OneMonth / OneYear) veya özel bir aralık "YYYY-MM-DD..YYYY-MM-DD". Zaman filtresi istemiyorsanız atlayın. NOT: "week"/"month" gibi değerler üst kaynakta sessizce yok sayılır.
değerler- One
Day - One
Week - One
Month - One
Year
- Tür: object200
Arama başarıyla tamamlandı.
Resultsıralanmış web sonuçlarını tutar.- Tür: objectResponse
Metadata Üst kaynak istek üst verisi.
- ActionTür: string
- RegionTür: string
- RequestTür: string
Id Bu istek için benzersiz tanımlayıcı.
- ServiceTür: string
- VersionTür: string
- Tür: objectResult
Arama sonucu yükü.
- ChoicesTür: array object[] | null
Ayrılmış; geçerli olmadıkça null.
Boş nesne - LogTür: string
Id Üst kaynak günlük kimliği (ResponseMetadata.RequestId ile aynıdır).
- ResultTür: integer
Count Döndürülen web sonucu sayısı.
- SearchTür: object
Context Çözümlenmiş sorgu bağlamının yansıması.
- OriginTür: string
Query - SearchTür: string
Type
- TimeTür: integer
Cost Milisaniye cinsinden üst kaynak işleme süresi.
- UsageTür: object | null
Ayrılmış; geçerli olmadıkça null.
- WebTür: array object[]
Results Sıralanmış web sonuçları listesi.
- IdTür: string
Opak sonuç kimliği.
- LogoTür: string
Url İmzalı site logosu URL'si (süreli).
- PublishTür: string
Time ISO 8601 biçiminde yayın zamanı (boş olabilir).
- PublishTür: integer
Time Unix Unix saniyesi olarak yayın zamanı (bilinmiyorsa 0).
- SiteTür: string
Name Kaynak site adı (boş olabilir).
- SnippetTür: string
Sayfadan kısa metin parçacığı.
- SortTür: integer
Id Sonucun 1'den başlayan sırası.
- SummaryTür: string
Sayfa içeriğinin daha uzun özeti.
- TitleTür: string
Sonuç başlığı.
- UrlTür: string
Sonuç URL'si.
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 https://openapi.felo.ai/v1/beta/byteplus/web-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"Query": "OpenAI news"
}'
{
"ResponseMetadata": {
"RequestId": "20260904155503A787EC832774768DC56F",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"ResultCount": 3,
"WebResults": [
{
"Id": "19b903d59c017bbb04c7832574500d49",
"SortId": 1,
"Title": "OpenAI News | OpenAI",
"SiteName": "OpenAI",
"Url": "https://openai.com/news/",
"Snippet": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"Summary": "Stay up to speed on the rapid advancement of AI technology and the benefits it offers to humanity.",
"PublishTime": "2026-09-03T07:50:20+08:00",
"PublishTimeUnix": 1788393020,
"LogoUrl": "https://p16-bpsearch-sign.ibyteimg.com/...<signed>"
}
],
"SearchContext": {
"OriginQuery": "OpenAI latest news",
"SearchType": "web"
},
"TimeCost": 935,
"LogId": "20260904155503A787EC832774768DC56F",
"Choices": null,
"Usage": null
}
}