BytePlus
Web search and page content retrieval.
بحث ويب فوري موجّه للذكاء الاصطناعي.
تنفيذ بحث ويب فوري مصمم لوكلاء الذكاء الاصطناعي وإرجاع قائمة مرتّبة من النتائج ذات العناوين مع الروابط والمقتطفات. Query مطلوب؛ ضيّق مجموعة النتائج باستخدام Count (≤ 20) وFilter (للاقتصار على Sites أو استبعاد BlockHosts) وLanguage وTimeRange. تغلّف الاستجابة ResponseMetadata.RequestId وقائمة Result من نتائج الويب. استخدمه لتوسيع استرجاع RAG ومراقبة المنافسين والعلاقات العامة والتحقق من الحقائق وتوريد المحتوى؛ واقترن كل عنوان URL ناتج بـ post_byteplus_fetch لجلب محتوى الصفحة الكامل.
مرجع التسعير
- القياس: أساس تكلفة ثابت لكل طلب ناجح.
- تقدير الطلب المرجعي: 0.0048 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. يجب عدم تطبيق مضاعفات المرجع مرة أخرى على مبالغ العملاء المسوّاة.
بيانات مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.
- النوع: stringQueryأقصى طول:400مطلوب
استعلام البحث. مطلوب. بحد أقصى 400 حرف؛ كما يحدّ محرك المنبع فعليًا عند نحو 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
تلميح لغة اختياري بصيغة المنبع، مثل EN أو ZH-HANS أو ZH-HANT.
- Time
Range نافذة حداثة اختيارية. إحدى النوافذ المسمّاة OneDay / OneWeek / OneMonth / OneYear، أو نطاق مخصص "YYYY-MM-DD..YYYY-MM-DD". احذفه لعدم تطبيق أي مرشّح زمني. ملاحظة: القيم مثل "week"/"month" يتم تجاهلها بصمت في المنبع.
- النوع: string تعداد
نافذة حداثة اختيارية. إحدى النوافذ المسمّاة OneDay / OneWeek / OneMonth / OneYear، أو نطاق مخصص "YYYY-MM-DD..YYYY-MM-DD". احذفه لعدم تطبيق أي مرشّح زمني. ملاحظة: القيم مثل "week"/"month" يتم تجاهلها بصمت في المنبع.
القيم- One
Day - One
Week - One
Month - One
Year
- النوع: object200
اكتمل البحث بنجاح. يحمل
Resultنتائج الويب المرتّبة.- النوع: objectResponse
Metadata بيانات وصفية لطلب المنبع.
- Actionالنوع: string
- Regionالنوع: string
- Requestالنوع: string
Id معرّف فريد لهذا الطلب.
- Serviceالنوع: string
- Versionالنوع: string
- النوع: objectResult
حمولة نتيجة البحث.
- Choicesالنوع: array object[] | null
محجوز؛ null ما لم ينطبق.
كائن فارغ - Logالنوع: string
Id معرّف سجل المنبع (يساوي ResponseMetadata.RequestId).
- Resultالنوع: integer
Count عدد نتائج الويب المُعادة.
- Searchالنوع: object
Context نسخة معكوسة من سياق الاستعلام المحلول.
- Originالنوع: string
Query - Searchالنوع: string
Type
- Timeالنوع: integer
Cost وقت معالجة المنبع بالمللي ثانية.
- 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
}
}