Google Autocomplete API

Get live keyword suggestions from Google’s autocomplete service. Set engine=google_autocomplete and pass the partial query in the q parameter to receive a structured list of suggestions.

Endpoint

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

Parameters

Parameter	Type	Required	Description
api_key	string	yes	Your SERP API key
engine	string	yes	Must be google_autocomplete
q	string	yes	The partial keyword to get suggestions for

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 overview
• Response shape
• Google Search API