クライアント API の移行

2027 年までに基本の Google CSE 検索を移行

対応する cse().list() と items の解析を維持。エンドポイントとキーを変更し、最初のページの Web 検索を移行。cx、ページング、画像検索の制限を明示します。

google-api-python-client — python diff
 from googleapiclient.discovery import build
 
 service = build('customsearch', 'v1',
-    developerKey='YOUR_GOOGLE_KEY',
+    developerKey='YOUR_SEARCH1API_KEY',
+    client_options={'api_endpoint': 'https://api.search1api.com/compat/google/'},
 )
 response = service.cse().list(q='hono workers', cx='YOUR_OLD_CX', num=5).execute()

移行を検討する場面

Google Custom Search JSON API は新規顧客の受付を終了し、既存顧客に 2027 年 1 月 1 日までの移行を求めています。Search1API は自社の Google エンジンで最初のページの Web 検索を提供し、終了予定の CSE API は呼び出しません。

元のサービスの資料: Google Custom Search JSON API notice

維持できるもの

対応する Google Python クライアントの cse().list() 呼び出し。
items[].title、link、snippet フィールドの解析。
Search1API キーを key クエリパラメーターまたは Bearer ヘッダーで送信。

切り替え前の確認事項

最初のページの Web 検索のみ。num は 1–10、start は 1。画像検索と SafeSearch の要求はエラーになります。
cx は互換用の値であり、Google のサイト設定や順位ルールを読み込みません。サイト制限を明示的に設定してください。
結果は異なる場合があります。総件数の推定、pagemap、nextPage は省略。無視されたオプションは X-Search1API-Ignored で確認できます。

既存クライアントを移行

ページング、画像検索、cx に保存された設定への依存を確認します。
Search1API キーとエンドポイントを設定。Python SDK の base は末尾のスラッシュを含む /compat/google/ です。
トラフィックを切り替える前にクエリ、サイト制限、エラー処理を検証します。

HTTP · first-page web search — bash
curl --get 'https://api.search1api.com/compat/google/customsearch/v1' \
  --data-urlencode 'q=hono workers' \
  --data-urlencode 'num=5' \
  -H "Authorization: Bearer $SEARCH1API_API_KEY"

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

クライアント例:google-api-python-client / HTTP clients互換性リファレンスを見る

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

料金を見る

移行に関する質問

cx を変更すれば設定も移行されますか？

いいえ。対応する呼び出しで cx を維持できますが、Google の設定は移行しません。単一サイトは siteSearch、複数サイトはネイティブ Search API の include_sites と exclude_sites を使用します。

Google Python SDK を使い続けられますか？

記載された基本の呼び出しで利用できます。google-api-python-client 2.201.0 の api_endpoint 設定、結果解析、HttpError 処理をローカルで検証済みです。他のラッパーには独自の設定が必要な場合があります。

埋め込みの Google Search Element も対象ですか？

対象は Custom Search JSON API です。Google の埋め込み JavaScript Search Element やサイト内検索 UI を置き換えるものではありません。

その他の移行ガイド

検索 API の移行 SearXNG Bing Web Search v7