BytePlus
Web search and page content retrieval.
Tìm kiếm web thời gian thực hướng tới AI.
Chạy tìm kiếm web thời gian thực dành cho tác nhân AI và trả về danh sách kết quả có thứ hạng với tiêu đề, liên kết và đoạn trích. Query là bắt buộc; thu hẹp tập kết quả bằng Count (≤ 20), Filter (chỉ giới hạn ở Sites hoặc loại trừ BlockHosts), Language và TimeRange. Phản hồi bọc ResponseMetadata.RequestId và danh sách Result các kết quả web. Dùng cho tăng cường truy xuất RAG, giám sát cạnh tranh/PR, kiểm chứng thông tin và tìm nguồn nội dung; ghép từng URL kết quả với post_byteplus_fetch để lấy toàn bộ nội dung trang.
Tham chiếu giá
- Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.0048.
- Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: stringQueryđộ dài tối đa:400bắt buộc
Truy vấn tìm kiếm. Bắt buộc. Tối đa 400 ký tự; công cụ của upstream cũng giới hạn thực tế khoảng 50 từ.
- Kiểu: integerCounttối đa:20
Số kết quả cần trả về. Tùy chọn; mặc định 10, tối đa 20.
- Kiểu: objectFilter
Bộ lọc kết quả tùy chọn. Cả hai trường là chuỗi tên miền đầy đủ phân tách bằng dấu gạch đứng (tối đa 5 mỗi trường).
- BlockKiểu: string
Hosts Loại trừ kết quả từ các tên miền đầy đủ này. Phân tách bằng dấu gạch đứng, tối đa 5, ví dụ "reddit.com|quora.com".
- SitesKiểu: string
Giới hạn kết quả trong các tên miền đầy đủ này. Phân tách bằng dấu gạch đứng, tối đa 5, ví dụ "bytedance.com|byteplus.com". (Gửi một mảng sẽ trả về 10400 Invalid Parameter.)
- Kiểu: stringLanguage
Gợi ý ngôn ngữ tùy chọn theo định dạng của upstream, ví dụ EN, ZH-HANS, ZH-HANT.
- Time
Range Cửa sổ thời gian gần đây tùy chọn. Một trong các cửa sổ có tên OneDay / OneWeek / OneMonth / OneYear, hoặc khoảng tùy chỉnh "YYYY-MM-DD..YYYY-MM-DD". Bỏ trống nếu không lọc theo thời gian. LƯU Ý: các giá trị như "week"/"month" bị upstream bỏ qua một cách im lặng.
- Kiểu: string enum
Cửa sổ thời gian gần đây tùy chọn. Một trong các cửa sổ có tên OneDay / OneWeek / OneMonth / OneYear, hoặc khoảng tùy chỉnh "YYYY-MM-DD..YYYY-MM-DD". Bỏ trống nếu không lọc theo thời gian. LƯU Ý: các giá trị như "week"/"month" bị upstream bỏ qua một cách im lặng.
giá trị- One
Day - One
Week - One
Month - One
Year
- Kiểu: object200
Tìm kiếm hoàn tất thành công.
Resultchứa các kết quả web đã xếp hạng.- Kiểu: objectResponse
Metadata Siêu dữ liệu yêu cầu của upstream.
- ActionKiểu: string
- RegionKiểu: string
- RequestKiểu: string
Id Định danh duy nhất cho yêu cầu này.
- ServiceKiểu: string
- VersionKiểu: string
- Kiểu: objectResult
Payload kết quả tìm kiếm.
- ChoicesKiểu: array object[] | null
Được bảo lưu; null trừ khi có áp dụng.
Đối tượng rỗng - LogKiểu: string
Id ID nhật ký của upstream (bằng ResponseMetadata.RequestId).
- ResultKiểu: integer
Count Số kết quả web được trả về.
- SearchKiểu: object
Context Bản sao ngữ cảnh truy vấn đã phân giải.
- OriginKiểu: string
Query - SearchKiểu: string
Type
- TimeKiểu: integer
Cost Thời gian xử lý của upstream tính bằng mili giây.
- UsageKiểu: object | null
Được bảo lưu; null trừ khi có áp dụng.
- WebKiểu: array object[]
Results Danh sách kết quả web đã xếp hạng.
- IdKiểu: string
ID kết quả không minh bạch.
- LogoKiểu: string
Url URL logo trang đã ký (có giới hạn thời gian).
- PublishKiểu: string
Time Thời gian xuất bản theo ISO 8601 (có thể trống).
- PublishKiểu: integer
Time Unix Thời gian xuất bản dưới dạng giây Unix (0 nếu không rõ).
- SiteKiểu: string
Name Tên trang nguồn (có thể trống).
- SnippetKiểu: string
Đoạn trích văn bản ngắn từ trang.
- SortKiểu: integer
Id Thứ hạng của kết quả, bắt đầu từ 1.
- SummaryKiểu: string
Bản tóm tắt dài hơn về nội dung trang.
- TitleKiểu: string
Tiêu đề kết quả.
- UrlKiểu: string
URL kết quả.
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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
}
}