これはGoogle Search APIを使うための実践的なエンドツーエンドガイドです:認証し、クエリを送り、JSONを読み、ページネーションし、エラーを処理し、コストを抑えます。例ではserp.cheap(2026年最安のオプション)を使いますが、概念はどのSERP APIにも当てはまります。
1. APIキーを取得する
最も手軽なのはapp.serp.cheap/loginから直接サインアップする方法です — 100回の無料検索が付き、クレジットカードは不要です。アカウントを作成するとX-API-Keyヘッダーで渡すキーが得られます。マーケットプレイス経由が好みなら、ApifyやRapidAPIからも利用できます。クレジットの有効期限は12か月です。
2. エンドポイントは一行で
POST https://api.serp.cheap/v1/search
| パラメータ | デフォルト | 説明 |
|---|---|---|
q | 必須 | 検索クエリ |
gl | "us" | 国(例:br、gb、de) |
hl | 国のデフォルト | UI言語の上書き |
page | 1 | 結果ページ(1始まり) |
tbs | なし | 時間フィルター:qdr:h、qdr:d、qdr:w |
完全なリファレンス:Google Search APIのパラメータ。
3. 最初のリクエスト
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "best electric cars 2026", "gl": "us", "page": 1}'
import requests
r = requests.post(
"https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": "best electric cars 2026", "gl": "us", "page": 1},
)
r.raise_for_status()
data = r.json()
for item in data["organic"]:
print(item["position"], item["title"], item["link"])
言語別ガイド:Python · Node.js · PHP · Go · curl。
4. レスポンスを読む
{
"search": "best electric cars 2026",
"page": 1,
"organic": [
{
"position": 1,
"title": "Best Electric Cars of 2026",
"link": "https://example.com/best-evs",
"snippet": "We tested every major EV...",
"date": "Jan 10, 2026"
}
],
"stats": { "balance": 99994, "cost": 6, "cached": false }
}
stats.costはクレジット単位です(1クレジット = $0.0001)。フレッシュ取得は6クレジット($0.0006)、キャッシュヒットは3クレジット($0.0003)です。stats.cachedでどちらの経路を通ったかがわかります。
5. ページネーション
各ページは個別のリクエストです — pageをインクリメントします。ユーザーが実際に必要とするときだけページ2以降を取得しましょう。100件の結果を取得するを参照してください。
6. エラー処理
- 401 — APIキーが不正/欠落。
- 402 — クレジット切れ;チャージしてください。
- 429 — レート制限(無料プランは毎分60リクエスト=1リクエスト/秒、従量課金は毎分600=10リクエスト/秒、上位プランで最大60リクエスト/秒);バックオフしてリトライ。
- 5xx — 一時的;指数バックオフでリトライ。
429/5xxに対しては常にバックオフ付きのリトライで呼び出しをラップしましょう。
7. 安く保つ
- キャッシュヒットは半額 — 繰り返しのクエリでフレッシュ取得を強制しない。
- 遅延的にページネーションする。
glを正確に選ぶことで再実行を避ける。
次のステップ
-
実際に何かを作る:PythonのランクトラッカーまたはAIエージェント向けGoogle Search。
-
プロバイダーを比較する:2026年最安のSERP API。
-
無料でサインアップしてAPIキーを取得する → — 100回の無料検索、クレジットカード不要