Google Autocomplete API

GoogleのオートコンプリートサービスからリアルタイムのキーワードサジェストIt取得します。engine=google_autocomplete を設定し、q パラメータに部分クエリを渡すことで、構造化されたサジェストのリストを取得できます。

エンドポイント

GET https://serp.shifter.io/v1?engine=google_autocomplete&api_key=YOUR_API_KEY

パラメーター

パラメーター	型	必須	説明
api_key	string	はい	お使いのSERP APIキー
engine	string	はい	google_autocomplete である必要があります
q	string	はい	候補を取得する対象の部分キーワード

リクエスト例

curl

curl "https://serp.shifter.io/v1?engine=google_autocomplete&api_key=YOUR_API_KEY&q=freecod"

Python

import requests

params = {
    "engine": "google_autocomplete",
    "api_key": "YOUR_API_KEY",
    "q": "freecod",
}
r = requests.get("https://serp.shifter.io/v1", params=params)
data = r.json()

Node.js

import fetch from 'node-fetch';

const url = 'https://serp.shifter.io/v1?' + new URLSearchParams({
  engine: 'google_autocomplete',
  api_key: 'YOUR_API_KEY',
  q: 'freecod',
});
const data = await (await fetch(url)).json();

レスポンス例

{
  "search_parameters": {
    "google_autocomplete_url": "https://www.google.com/",
    "engine": "google_autocomplete",
    "google_domain": "google.com",
    "device": "desktop",
    "query": "freecod"
  },
  "search_information": {
    "autocomplete_results_state": "Showing completion results."
  },
  "suggestions": [
    { "suggestion": "freecodecamp" },
    { "suggestion": "freecodecamp python" },
    { "suggestion": "freecodecamp javascript" },
    { "suggestion": "freecodecamp review" },
    { "suggestion": "freecodecamp java" },
    { "suggestion": "freecodecamp vs codecademy" },
    { "suggestion": "freecodecamp c++" },
    { "suggestion": "freecodecamp certificate" },
    { "suggestion": "freecodecamp react" },
    { "suggestion": "freecodecamp sql" }
  ]
}

関連項目

• Google SERP overview
• Response shape
• Google Search API