Google 자동완성 API

Google의 자동완성 서비스로부터 실시간 키워드 제안을 받아옵니다. engine=google_autocomplete를 설정하고 q 파라미터에 부분 검색어를 전달하면 구조화된 제안 목록을 받을 수 있습니다.

Endpoint

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

Parameters

Parameter	Type	Required	Description
api_key	string	yes	사용자의 SERP API 키
engine	string	yes	google_autocomplete여야 합니다
q	string	yes	제안을 받을 부분 키워드

Example request

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();

Example response

{
  "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" }
  ]
}

See also

• Google SERP 개요
• 응답 형식
• Google Search API