クライアント API の移行

Bing v7 クライアントを Search1API へ移行

対応する Bing v7 クライアントのエンドポイントとキーを変更。Bing を利用する互換 API で webPages.value の結果形式を維持します。

Open WebUI — bash diff
-BING_SEARCH_V7_ENDPOINT="https://api.bing.microsoft.com/v7.0/search"
-BING_SEARCH_V7_SUBSCRIPTION_KEY="YOUR_BING_KEY"
+BING_SEARCH_V7_ENDPOINT="https://api.search1api.com/compat/bing/v7.0/search"
+BING_SEARCH_V7_SUBSCRIPTION_KEY="YOUR_SEARCH1API_KEY"

移行を検討する場面

Microsoft は 2025 年 8 月 11 日に Bing Search API を終了し、既存インスタンスを停止しました。v7 の結果形式を必要とするアプリ向けに、Search1API は Bing エンジンを使う Web・ニュース・画像検索の互換エンドポイントを提供します。

元のサービスの資料: Microsoft Bing Search API retirement notice

維持できるもの

対応する Bing v7 のクエリパラメーターと結果解析。
Ocp-Apim-Subscription-Key ヘッダーで Search1API キーを送信。
エンドポイントを設定できる Open WebUI と LangChain の Bing 連携。

切り替え前の確認事項

順位やメタデータは旧 API と異なる場合があります。回答や追加レスポンスセクションは再現しません。
safeSearch、responseFilter、textDecorations などは無視されます。依存する場合はパラメーターの対応を確認してください。
totalEstimatedMatches は返された結果範囲を示し、全件数の推定ではありません。ニュース検索には q が必須で、クエリなしのトップニュースは対象外です。

既存クライアントを移行

Search1API キーを作成し、Azure subscription key を置き換えます。
Bing のエンドポイントを /compat/bing/v7.0/search に設定。ニュースと画像には専用パスを使います。
代表的なクエリで webPages.value、フィルター、ページング、エラー処理を検証します。

LangChain · BingSearchAPIWrapper — python
from langchain_community.utilities import BingSearchAPIWrapper
search = BingSearchAPIWrapper(
    bing_subscription_key="YOUR_SEARCH1API_KEY",
    bing_search_url="https://api.search1api.com/compat/bing/v7.0/search",
    k=5,
)
results = search.results("hono workers", 5)

例は互換性リファレンスと一致しています。本番トラフィックの切り替え前に、ご自身のクエリでフィルターと結果処理を確認してください。

クライアント例:Open WebUI / LangChain互換性リファレンスを見る

検索には Search1API のクレジットとアカウントのレート制限が適用されます。本文取得や複数エンジンの選択は追加料金になる場合があります。各プロトコルの説明をご確認ください。

料金を見る

移行に関する質問

Azure リソースは必要ですか？

不要です。Search1API のキー、クレジット、レート制限を使用します。旧 Azure リソースを利用したり、終了した Microsoft のサービスを復活させたりするものではありません。

ニュースと画像に対応していますか？

はい。/v7.0/news/search と /v7.0/images/search を別々に提供します。フィールドと動作の違いはリファレンスをご確認ください。

すべての旧 Bing クライアントを移行できますか？

エンドポイントとキーを変更できる必要があります。LangChain BingSearchAPIWrapper と Open WebUI のリクエスト形式を検証済みです。固定された Microsoft ホスト名を使うクライアントには設定対応やコード変更が必要です。

その他の移行ガイド

検索 API の移行 SearXNG Google Custom Search JSON API