すべてのGoogleエンジンは同じエンドポイントを共有しており、engineパラメータを切り替えることで返される内容が変わります。
https://serp.shifter.io/v1?engine=<engine>&api_key=YOUR_API_KEY&q=<query>engine | 戻り値 | 主なパラメータ |
|---|---|---|
google | オーガニック検索結果、広告、スニペット、PAA、ナレッジグラフ | q, location, gl, hl, device |
google_autocomplete | 部分的なクエリに対する候補 | q |
google_images | 画像検索結果 | q, location |
google_maps | マップ上のビジネス、レビュー、写真 | q, type=search|place|review, ll |
google_maps_reviews | 特定の場所のすべてのレビュー | data_id |
google_maps_photos | 特定の場所のすべての写真 | data_id |
google_news | 日付と情報源付きのニュース検索結果 | q, gl, hl |
google_shopping | 価格付きの商品リスト | q, location |
google_product | 単一商品の詳細ページ | product_id |
google_jobs | 求人情報 | q, location |
google_jobs_listing | 求人1件の詳細情報 | q(base64形式の求人ID) |
google_trends | 期間別の関心度データ | q, geo, date |
google_scholar | 学術論文の検索結果 | q |
google_scholar_author | 著者プロフィールと論文 | author_id |
google_scholar_cite | 1件の論文の整形済み引用情報 | q(引用ID) |
google_scholar_profiles | 名前による著者検索 | mauthors |
google_events | 地域のイベント | q, location |
google_play | Playストアのアプリ、書籍、映画 | type, store, product_id |
google_finance | 株式および市場データ | q |
google_reverse_image | 画像を掲載しているページ | image_url |
google_local_services | 地域のサービス一覧 | q, location |
共通パラメータ
Section titled “共通パラメータ”| パラメータ | 用途 |
|---|---|
q | 検索クエリ |
location | 自由形式の位置情報文字列(例: "New York, NY") |
gl | 国コード(例: us、de) |
hl | インターフェース言語(例: en、es) |
device | desktop または mobile |
start | ページネーション用の結果オフセット |
num | 1ページあたりの結果数 |
各エンジンの完全なパラメータリファレンスは、REST API → Google SERP セクションにあります。
例: 位置情報を指定したGoogle検索
Section titled “例: 位置情報を指定したGoogle検索”curl "https://serp.shifter.io/v1?engine=google&api_key=YOUR_API_KEY&q=best+pizza&location=Chicago%2C+Illinois&device=mobile"例: Googleマップ検索
Section titled “例: Googleマップ検索”curl "https://serp.shifter.io/v1?engine=google_maps&api_key=YOUR_API_KEY&q=pizza&type=search&ll=@41.8781,-87.6298,14z"例: Google求人
Section titled “例: Google求人”curl "https://serp.shifter.io/v1?engine=google_jobs&api_key=YOUR_API_KEY&q=software+engineer&location=Austin%2C+Texas"次のステップ
Section titled “次のステップ”- Locations、自由形式の
location文字列を超えた正確なジオターゲティング。 - REST API → Google SERP、すべてのエンジンの完全なパラメータリファレンス。