Веб-поиск в реальном времени для 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 символов; движок 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 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
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
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
}
}