AI کے لیے بنائی گئی حقیقی وقت کی ویب تلاش۔
BytePlus
Web search and page content retrieval.
AI کے لیے بنائی گئی حقیقی وقت کی ویب تلاش۔
AI ایجنٹس کے لیے بنائی گئی حقیقی وقت کی ویب تلاش چلائیں اور عنوان والے نتائج کی درجہ بند فہرست لنکس اور اسنیپٹس کے ساتھ واپس کریں۔ Query درکار ہے؛ نتیجہ سیٹ کو Count (≤ 20)، Filter (Sites تک محدود کرنے یا BlockHosts کو خارج کرنے کے لیے)، Language اور TimeRange سے محدود کریں۔ جواب ResponseMetadata.RequestId اور ویب نتائج کی Result فہرست کو لپیٹتا ہے۔ اسے RAG ریٹریول آگمینٹیشن، مسابقتی/PR نگرانی، فیکٹ چیکنگ اور مواد کی سورسنگ کے لیے استعمال کریں؛ مکمل صفحہ مواد کھینچنے کے لیے ہر نتیجے کے URL کو post_byteplus_fetch کے ساتھ جوڑیں۔
قیمت کا حوالہ
- میٹرنگ: کامیاب درخواست کی مقررہ لاگت کی بنیاد۔
- حوالہ جاتی درخواست کا تخمینہ: USD 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 enum
اختیاری حالیہ پن کی ونڈو۔ نامزد ونڈوز میں سے ایک 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 اپ اسٹریم لاگ 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
اوپیک نتیجہ 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
درخواست پر کارروائی نہیں ہو سکی۔ درخواست کے پیرامیٹرز چیک کریں۔
- 401
درست Felo API کلید درکار ہے۔
- 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
}
}