BytePlus
Web search and page content retrieval.
AI-केंद्रित रीयल-टाइम वेब सर्च।
AI एजेंट के लिए बनी रीयल-टाइम वेब सर्च चलाएँ और लिंक व स्निपेट सहित शीर्षक वाले रैंक किए गए परिणाम लौटाएँ। Query आवश्यक है; परिणाम सेट को Count (≤ 20), Filter (Sites तक सीमित करें या BlockHosts बाहर रखें), Language और TimeRange से संकीर्ण करें। response में ResponseMetadata.RequestId और वेब परिणामों की Result सूची होती है। इसे RAG रिट्रीवल ऑगमेंटेशन, प्रतिस्पर्धी/PR मॉनिटरिंग, फ़ैक्ट-चेकिंग और कंटेंट सोर्सिंग के लिए उपयोग करें; पूरी पेज सामग्री खींचने के लिए हर परिणाम URL को post_byteplus_fetch के साथ जोड़ें।
मूल्य संदर्भ
- मीटरिंग: सफल request के निश्चित लागत आधार पर
- संदर्भ request अनुमान: USD 0.0048
- संदर्भ ग्राहक गुणक: 1.0। निपटाई गई ग्राहक राशि पर इसे दोबारा लागू न करें।
यह केवल संदर्भ मेटाडेटा है — खाते का कोटेशन, गारंटीशुदा मूल्य या खर्च सीमा नहीं। रिसोर्स क्रेडिट Felo क्रेडिट नहीं हैं। अंतिम शुल्क Felo बिलिंग रिकॉर्ड के अनुसार लगते हैं।
- टाइप: stringQueryअधिकतम लंबाई:400आवश्यक
सर्च क्वेरी। आवश्यक। अधिकतम 400 अक्षर; upstream इंजन भी व्यावहारिक रूप से लगभग 50 शब्दों की सीमा लगाता है।
- टाइप: integerCountअधिकतम:20
लौटाने के लिए परिणामों की संख्या। वैकल्पिक; डिफ़ॉल्ट 10, अधिकतम 20।
- टाइप: objectFilter
वैकल्पिक परिणाम फ़िल्टर। दोनों फ़ील्ड पूर्ण डोमेन की पाइप-सेपरेटेड स्ट्रिंग हैं (प्रत्येक में अधिकतम 5)।
- Blockटाइप: string
Hosts इन पूर्ण डोमेन से परिणाम बाहर रखें। पाइप-सेपरेटेड, अधिकतम 5, जैसे "reddit.com|quora.com"।
- Sitesटाइप: string
परिणामों को इन पूर्ण डोमेन तक सीमित करें। पाइप-सेपरेटेड, अधिकतम 5, जैसे "bytedance.com|byteplus.com"। (ऐरे भेजने पर 10400 Invalid Parameter मिलता है।)
- टाइप: stringLanguage
upstream प्रारूप में वैकल्पिक भाषा संकेत, जैसे EN, ZH-HANS, ZH-HANT।
- Time
Range वैकल्पिक रीसेंसी विंडो। OneDay / OneWeek / OneMonth / OneYear में से कोई नामित विंडो, या कस्टम रेंज "YYYY-MM-DD..YYYY-MM-DD"। समय फ़िल्टर न चाहिए तो इसे छोड़ दें। नोट: "week"/"month" जैसे मान upstream द्वारा चुपचाप अनदेखा कर दिए जाते हैं।
- टाइप: string enum
वैकल्पिक रीसेंसी विंडो। OneDay / OneWeek / OneMonth / OneYear में से कोई नामित विंडो, या कस्टम रेंज "YYYY-MM-DD..YYYY-MM-DD"। समय फ़िल्टर न चाहिए तो इसे छोड़ दें। नोट: "week"/"month" जैसे मान upstream द्वारा चुपचाप अनदेखा कर दिए जाते हैं।
मान- One
Day - One
Week - One
Month - One
Year
- टाइप: object200
सर्च सफलतापूर्वक पूरी हुई।
Resultमें रैंक किए गए वेब परिणाम हैं।- टाइप: objectResponse
Metadata upstream request मेटाडेटा।
- Actionटाइप: string
- Regionटाइप: string
- Requestटाइप: string
Id इस request का अनूठा पहचानकर्ता।
- Serviceटाइप: string
- Versionटाइप: string
- टाइप: objectResult
सर्च परिणाम पेलोड।
- Choicesटाइप: array object[] | null
आरक्षित; लागू न होने पर null।
खाली ऑब्जेक्ट - Logटाइप: string
Id upstream log id (ResponseMetadata.RequestId के बराबर)।
- Resultटाइप: integer
Count लौटाए गए वेब परिणामों की संख्या।
- Searchटाइप: object
Context resolve किए गए query संदर्भ की प्रतिध्वनि।
- Originटाइप: string
Query - Searchटाइप: string
Type
- Timeटाइप: integer
Cost मिलीसेकंड में upstream प्रोसेसिंग समय।
- Usageटाइप: object | null
आरक्षित; लागू न होने पर null।
- Webटाइप: array object[]
Results वेब परिणामों की रैंक की गई सूची।
- Idटाइप: string
अपारदर्शी परिणाम id।
- Logoटाइप: string
Url साइन किया गया साइट लोगो URL (समय-सीमित)।
- Publishटाइप: string
Time ISO 8601 में प्रकाशन समय (खाली हो सकता है)।
- Publishटाइप: integer
Time Unix Unix सेकंड में प्रकाशन समय (अज्ञात होने पर 0)।
- Siteटाइप: string
Name स्रोत साइट का नाम (खाली हो सकता है)।
- Snippetटाइप: string
पेज से छोटा टेक्स्ट स्निपेट।
- Sortटाइप: integer
Id परिणाम की 1-आधारित रैंक।
- Summaryटाइप: string
पेज कंटेंट का लंबा सारांश।
- Titleटाइप: string
परिणाम शीर्षक।
- Urlटाइप: string
परिणाम URL।
application/json - 400
request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।
- 401
एक वैध Felo API key आवश्यक है।
- 402
request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।
- 403
खाते को यह ऑपरेशन करने की अनुमति नहीं है।
- 429
request या खर्च की सीमा तक पहुँच गए हैं।
- 502
सेवा request पूरा नहीं कर सकी।
- 503
API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।
- 504
request संसाधित करते समय सेवा का समय समाप्त हो गया।
- default
त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।
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
}
}