Google Search APIから適切な結果を得るかどうかは、ほとんどパラメータで決まります。serp.cheapを使った完全リファレンスをここに示します。
すべてのパラメータ
| パラメータ | 型 | デフォルト | 役割 |
|---|---|---|---|
q | string | 必須 | 検索クエリ |
gl | string | "us" | 結果の国 (地理的位置) |
hl | string | 国のデフォルト | 表示/インターフェース言語 |
page | int | 1 | 結果ページ (1始まり) |
tbs | string | なし | 期間フィルタ (qdr:h/qdr:d/qdr:w) |
gl — 国 (最もよく使うパラメータ)
glはどのGoogleにアクセスするか、そしてどの地域のランキングを取得するかを決定します。対応: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl。
-d '{"q": "beste elektroautos", "gl": "de"}' # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}' # Brazil
hl — 言語の上書き
glはすでに適切なデフォルト言語を設定します。hlは、国のデフォルトとは異なる言語で結果を取得したい場合にのみ使用してください:
-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}' # Canada, in French
tbs — 期間フィルタ
最近の結果に限定します — ニュース、モニタリング、トレンドのトピックに最適です:
-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}' # past 24 hours
| 値 | 期間 |
|---|---|
qdr:h | 過去1時間 |
qdr:d | 過去1日 |
qdr:w | 過去1週間 |
page — ページネーション
1始まりです。各ページは個別に課金されるリクエストです。100件の結果を取得する方法を参照してください。
まとめて使う
curl https://api.serp.cheap/v1/search \
-H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
-d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'