InstaRank SEO
Autocomplete API

Google Autocomplete API

Return the live Google search suggestions a user sees while typing — perfect for keyword expansion, content ideation, and search-trend discovery.

GET/api/v1/autocomplete$1 per 1,000 queriesscope autocomplete:read
Get your API keyFull API reference
Quick start

One request, structured JSON back

Request
curl "https://instarankseo.com/api/v1/autocomplete?q=how%20to%20learn&country=us" \
  -H "X-API-Key: isk_your_key_here"
Response
{
  "success": true,
  "query": "how to learn",
  "count": 10,
  "suggestions": [
    "how to learn spanish",
    "how to learn python",
    "how to learn guitar"
  ],
  "meta": { "creditsUsed": 1, "creditsRemaining": 18999, "apiVersion": "1.0" }
}
Reference

Parameters

FieldTypeRequiredDescription
qstringrequiredThe partial query to autocomplete (query string).
countrystringoptional2-letter ISO country code to localize suggestions.
Why this API

Built for builders

Real search suggestions

The exact autocomplete suggestions Google surfaces as people type — a direct window into how searchers phrase their intent.

Built for expansion

Seed a single term and fan out into dozens of long-tail variations to power keyword research and content briefs.

Fast and simple

A single GET request, no body to build. Sub-second responses make it easy to call interactively or in bulk.

Transparent

Pricing & limits

Price

$1 per 1,000 queries

1 credit per query

Billed from one credit wallet. Failed upstream calls are refunded automatically.

Rate limits

  • Free10 / min
  • SEO+60 / min
  • Agency120 / min

Surfaced as X-RateLimit-* headers on every response.

Errors

Every non-2xx shares one envelope with a machine-readable code, a retryable flag, and a requestId for tracing.

Send an Idempotency-Key header to retry POSTs safely without double-charging.

A clean, JSON autocomplete feed without scraping the suggestions box yourself — ideal for long-tail keyword expansion at $1 per 1,000 calls.

Get your API keyBrowse all APIs

Last updated:

FAQ

Google Autocomplete API FAQ

Common questions about the Google Autocomplete API — pricing, auth, and what it returns.

  • What is the Autocomplete API for?

    It returns the live search suggestions Google shows while a user types a query. Those suggestions are an excellent source of long-tail keyword ideas, content topics, and insight into how real searchers phrase their needs.

  • How is it priced?

    One credit per query, which is $1 per 1,000 queries at the standard rate.

  • Is it a GET or POST request?

    A GET request. Pass your partial query as the q query-string parameter and an optional 2-letter country code — there is no request body to build.

  • Can I localize suggestions?

    Yes. Add a country parameter with a 2-letter ISO code to get suggestions tailored to that market.

  • Which scope is required?

    The autocomplete:read scope. Send your key in the X-API-Key header.