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 列挙値
任意の時間範囲。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
}
}