クイックスタート

serp.cheap は単一の HTTPS エンドポイントを通じて Google 検索をクリーンな JSON に変換します。

• ベース URL: https://api.serp.cheap
• エンドポイント: POST /v1/search
• 認証: x-api-key ヘッダー

1. API キーを取得する

app.serp.cheap にサインインしてキーを作成します。すべての新規アカウントは 無料クレジットで始まります。

2. リクエストを送る

クエリを JSON として、キーを x-api-key ヘッダーに入れて送信します。

curl

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "best running shoes", "gl": "us" }'

JavaScript

import { SerpCheap } from "@serpcheap/sdk";

const client = new SerpCheap("YOUR_API_KEY");
const res = await client.search({ q: "best running shoes", gl: "us" });
console.log(res.organic[0].title);

Python

from serpcheap import SerpCheap

client = SerpCheap("YOUR_API_KEY")
res = client.search(q="best running shoes", gl="us")
print(res.organic[0].title)

3. レスポンスを読む

結果はランク付けされて返され、オプションの Knowledge Graph と課金統計が含まれます。

{
  "search": "best running shoes",
  "page": 1,
  "organic": [
    {
      "position": 1,
      "title": "The 10 Best Running Shoes of 2026",
      "link": "https://example.com/best-running-shoes",
      "snippet": "Our running experts tested 40+ pairs…"
    }
  ],
  "knowledgeGraph": { "title": "Running shoe", "description": "…" },
  "stats": { "balance": 9994, "cost": 6, "cached": false }
}

1 回の検索 = 1 回のフレッシュ取得

フレッシュ取得は 6 クレジット、キャッシュヒットは 3 クレジットです。stats.cost は各呼び出しで 正確にいくら課金されたかを示し、stats.balance は残高です。料金とクレジットを参照してください。

次のステップ

• 認証 — キー、ヘッダー、認証エラー。
• 検索パラメータ — 国、言語、時間フィルター、ページネーション。
• レスポンス構造 — オーガニック、広告、Knowledge Graph、関連検索。
• SDK — JS、Python、Go、Rust、Java 向けの公式ライブラリ。