BytePlus
Web search and page content retrieval.
Carian web masa nyata berorientasikan AI.
Jalankan carian web masa nyata yang dibina untuk agen AI dan pulangkan senarai hasil berkedudukan dengan tajuk, pautan dan coretan. Query diperlukan; sempitkan set hasil dengan Count (≤ 20), Filter (hadkan kepada Sites atau kecualikan BlockHosts), Language dan TimeRange. Respons membungkus ResponseMetadata.RequestId dan senarai Result hasil web. Gunakan untuk penambahan pengambilan RAG, pemantauan pesaing/PR, pengesahan fakta dan sumber kandungan; pasangkan setiap URL hasil dengan post_byteplus_fetch untuk mengambil kandungan halaman penuh.
Rujukan harga
- Pemeteran: Asas kos tetap bagi setiap permintaan berjaya.
- Anggaran rujukan setiap permintaan: USD 0.0048.
- Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: stringQuerypanjang maksimum:400wajib
Kueri carian. Diperlukan. Maksimum 400 aksara; enjin huluan juga secara berkesan mengehadkan sekitar 50 perkataan.
- Jenis: integerCountmaks:20
Bilangan hasil untuk dipulangkan. Pilihan; lalai 10, maksimum 20.
- Jenis: objectFilter
Penapis hasil pilihan. Kedua-dua medan ialah rentetan domain penuh yang dipisahkan paip (maksimum 5 setiap satu).
- BlockJenis: string
Hosts Kecualikan hasil daripada domain penuh ini. Dipisahkan paip, maksimum 5, cth. "reddit.com|quora.com".
- SitesJenis: string
Hadkan hasil kepada domain penuh ini. Dipisahkan paip, maksimum 5, cth. "bytedance.com|byteplus.com". (Menghantar array memulangkan 10400 Invalid Parameter.)
- Jenis: stringLanguage
Petunjuk bahasa pilihan dalam format huluan, cth. EN, ZH-HANS, ZH-HANT.
- Time
Range Tetingkap kebaruan pilihan. Salah satu tetingkap bernama OneDay / OneWeek / OneMonth / OneYear, atau julat tersuai "YYYY-MM-DD..YYYY-MM-DD". Tinggalkan kosong untuk tanpa penapis masa. NOTA: nilai seperti "week"/"month" diabaikan secara senyap oleh huluan.
- Jenis: string enum
Tetingkap kebaruan pilihan. Salah satu tetingkap bernama OneDay / OneWeek / OneMonth / OneYear, atau julat tersuai "YYYY-MM-DD..YYYY-MM-DD". Tinggalkan kosong untuk tanpa penapis masa. NOTA: nilai seperti "week"/"month" diabaikan secara senyap oleh huluan.
nilai- One
Day - One
Week - One
Month - One
Year
- Jenis: object200
Carian berjaya.
Resultmenyimpan hasil web berkedudukan.- Jenis: objectResponse
Metadata Metadata permintaan huluan.
- ActionJenis: string
- RegionJenis: string
- RequestJenis: string
Id Pengecam unik bagi permintaan ini.
- ServiceJenis: string
- VersionJenis: string
- Jenis: objectResult
Muatan hasil carian.
- ChoicesJenis: array object[] | null
Dikhususkan; null melainkan berkenaan.
Objek kosong - LogJenis: string
Id ID log huluan (sama dengan ResponseMetadata.RequestId).
- ResultJenis: integer
Count Bilangan hasil web yang dipulangkan.
- SearchJenis: object
Context Gema konteks kueri yang telah diselesaikan.
- OriginJenis: string
Query - SearchJenis: string
Type
- TimeJenis: integer
Cost Masa pemprosesan huluan dalam milisaat.
- UsageJenis: object | null
Dikhususkan; null melainkan berkenaan.
- WebJenis: array object[]
Results Senarai hasil web berkedudukan.
- IdJenis: string
ID hasil legap.
- LogoJenis: string
Url URL logo laman bertandatangan (terhad masa).
- PublishJenis: string
Time Masa terbit dalam ISO 8601 (mungkin kosong).
- PublishJenis: integer
Time Unix Masa terbit dalam saat Unix (0 jika tidak diketahui).
- SiteJenis: string
Name Nama laman sumber (mungkin kosong).
- SnippetJenis: string
Coretan teks pendek daripada halaman.
- SortJenis: integer
Id Kedudukan hasil, bermula dari 1.
- SummaryJenis: string
Ringkasan kandungan halaman yang lebih panjang.
- TitleJenis: string
Tajuk hasil.
- UrlJenis: string
URL hasil.
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin 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
}
}