BytePlus
Web search and page content retrieval.
חיפוש אינטרנט בזמן אמת המיועד ל-AI.
הרצת חיפוש אינטרנט בזמן אמת המיועד לסוכני AI והחזרת רשימה מדורגת של תוצאות עם כותרות, קישורים ותקצירים. Query הוא שדה חובה; צמצמו את התוצאות עם Count (≤ 20), Filter (הגבלה ל-Sites או החרגת BlockHosts), Language ו-TimeRange. התגובה עוטפת את ResponseMetadata.RequestId ורשימת Result של תוצאות אינטרנט. השתמשו בו להרחבת שליפה ב-RAG, לניטור מתחרים ויחסי ציבור, לאימות עובדות ולהשגת תוכן; שלבו כל כתובת תוצאה עם post_byteplus_fetch כדי לשלוף את תוכן העמוד המלא.
מראה תמחור
- מדידה: בסיס עלות קבוע לבקשה מוצלחת.
- אומדן בקשה לעיון: 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.
- Actionסוג: string
- Regionסוג: string
- Requestסוג: string
Id מזהה ייחודי לבקשה הזו.
- Serviceסוג: string
- Versionסוג: string
- סוג: objectResult
מטען תוצאת החיפוש.
- Choicesסוג: array object[] | null
שמור; null אלא אם רלוונטי.
אובייקט ריק - Logסוג: string
Id מזהה היומן ב-upstream (שווה ל-ResponseMetadata.RequestId).
- Resultסוג: integer
Count מספר תוצאות האינטרנט שהוחזרו.
- Searchסוג: object
Context הד של הקשר השאילתה שנפתר.
- Originסוג: string
Query - Searchסוג: string
Type
- Timeסוג: integer
Cost זמן העיבוד ב-upstream במילישניות.
- Usageסוג: object | null
שמור; null אלא אם רלוונטי.
- Webסוג: array object[]
Results רשימת תוצאות אינטרנט מדורגת.
- Idסוג: string
מזהה תוצאה אטום.
- Logoסוג: string
Url כתובת URL חתומה של לוגו האתר (מוגבלת בזמן).
- Publishסוג: string
Time זמן הפרסום ב-ISO 8601 (עשוי להיות ריק).
- Publishסוג: integer
Time Unix זמן הפרסום בשניות יוניקס (0 אם לא ידוע).
- Siteסוג: string
Name שם אתר המקור (עשוי להיות ריק).
- Snippetסוג: string
קטע טקסט קצר מהעמוד.
- Sortסוג: integer
Id דירוג התוצאה החל מ-1.
- Summaryסוג: string
סיכום ארוך יותר של תוכן העמוד.
- Titleסוג: string
כותרת התוצאה.
- Urlסוג: string
כתובת ה-URL של התוצאה.
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
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
}
}