BytePlus
Web search and page content retrieval.
Pencarian web real-time berorientasi AI.
Jalankan pencarian web real-time yang dirancang untuk agen AI dan kembalikan daftar hasil berperingkat dengan judul, tautan, dan cuplikan. Query wajib; persempit kumpulan hasil dengan Count (≤ 20), Filter (batasi ke Sites atau kecualikan BlockHosts), Language, dan TimeRange. Respons membungkus ResponseMetadata.RequestId dan daftar Result hasil web. Gunakan untuk augmentasi pengambilan RAG, pemantauan pesaing/PR, verifikasi fakta, dan sumber konten; pasangkan setiap URL hasil dengan post_byteplus_fetch untuk mengambil konten halaman penuh.
Referensi harga
- Metering: Dasar biaya tetap per permintaan berhasil.
- Estimasi referensi per permintaan: USD 0.0048.
- 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.
- Tipe: stringQuerypanjang maks:400wajib
Kueri pencarian. Wajib. Maksimal 400 karakter; mesin upstream juga secara efektif membatasi sekitar 50 kata.
- Tipe: integerCountmaks:20
Jumlah hasil yang dikembalikan. Opsional; default 10, maksimum 20.
- Tipe: objectFilter
Filter hasil opsional. Kedua field adalah string domain penuh yang dipisahkan pipa (maksimal 5 masing-masing).
- BlockTipe: string
Hosts Kecualikan hasil dari domain penuh ini. Dipisahkan pipa, maksimal 5, mis. "reddit.com|quora.com".
- SitesTipe: string
Batasi hasil ke domain penuh ini. Dipisahkan pipa, maksimal 5, mis. "bytedance.com|byteplus.com". (Mengirim array mengembalikan 10400 Invalid Parameter.)
- Tipe: stringLanguage
Petunjuk bahasa opsional dalam format upstream, mis. EN, ZH-HANS, ZH-HANT.
- Time
Range Jendela kebaruan opsional. Salah satu jendela bernama OneDay / OneWeek / OneMonth / OneYear, atau rentang khusus "YYYY-MM-DD..YYYY-MM-DD". Hilangkan untuk tanpa filter waktu. CATATAN: nilai seperti "week"/"month" diabaikan diam-diam oleh upstream.
- Tipe: string enum
Jendela kebaruan opsional. Salah satu jendela bernama OneDay / OneWeek / OneMonth / OneYear, atau rentang khusus "YYYY-MM-DD..YYYY-MM-DD". Hilangkan untuk tanpa filter waktu. CATATAN: nilai seperti "week"/"month" diabaikan diam-diam oleh upstream.
nilai- One
Day - One
Week - One
Month - One
Year
- Tipe: object200
Pencarian berhasil.
Resultberisi hasil web berperingkat.- Tipe: objectResponse
Metadata Metadata permintaan upstream.
- ActionTipe: string
- RegionTipe: string
- RequestTipe: string
Id Pengenal unik untuk permintaan ini.
- ServiceTipe: string
- VersionTipe: string
- Tipe: objectResult
Payload hasil pencarian.
- ChoicesTipe: array object[] | null
Direservasi; null kecuali berlaku.
Objek kosong - LogTipe: string
Id ID log upstream (sama dengan ResponseMetadata.RequestId).
- ResultTipe: integer
Count Jumlah hasil web yang dikembalikan.
- SearchTipe: object
Context Gema konteks kueri yang telah diselesaikan.
- OriginTipe: string
Query - SearchTipe: string
Type
- TimeTipe: integer
Cost Waktu pemrosesan upstream dalam milidetik.
- UsageTipe: object | null
Direservasi; null kecuali berlaku.
- WebTipe: array object[]
Results Daftar hasil web berperingkat.
- IdTipe: string
ID hasil opak.
- LogoTipe: string
Url URL logo situs bertanda tangan (terbatas waktu).
- PublishTipe: string
Time Waktu terbit dalam ISO 8601 (mungkin kosong).
- PublishTipe: integer
Time Unix Waktu terbit dalam detik Unix (0 jika tidak diketahui).
- SiteTipe: string
Name Nama situs sumber (mungkin kosong).
- SnippetTipe: string
Cuplikan teks pendek dari halaman.
- SortTipe: integer
Id Peringkat hasil, dimulai dari 1.
- SummaryTipe: string
Ringkasan konten halaman yang lebih panjang.
- TitleTipe: string
Judul hasil.
- UrlTipe: string
URL hasil.
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
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
}
}