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 символів; движок 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 перелік
Необов'язкове вікно свіжості. Одне з іменованих вікон 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 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
Непрозорий 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
Потрібен дійсний 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
}
}