Google Autocomplete API — Search Suggestions
Documentation menu
FetchLayer FetchLayer API

Get Google search suggestions

The suggestions Google’s search box offers for a partial query, in Google’s order, for a country and language — useful for keyword research and for finding how people phrase a search. Takes country and language only; location, device, safe search or time range is a 400. Billing: one request.

POST /autocomplete Keyword research
https://api.fetchlayer.dev/google-search/autocomplete
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

query string required

The partial query to complete (1–300 characters).

country string optional

Two-letter country the results are for: US, GB, DE, FR, IN, BR and so on. Case-insensitive. Rankings differ by country. (default: US)

language string optional

Interface and snippet language: en, de, fr, pt-BR and so on. (default: en)

format string optional

json or markdown. (default: json)

timeoutMs number optional

Time limit for each result page read, in milliseconds (1000–60000).

Response Fields

autocomplete

Get Google search suggestions

resultType string

search, rank-check or autocomplete.

requestedUrl string

The Google page this result corresponds to.

notes string[]

Caveats about this particular result — a result whose link could not be followed, a page that could not be read. Empty when there are none. Read it on every call.

transport string

The source this data came from. Always "google".

scrapedAt string

ISO 8601 timestamp of when the data was collected.

query string

The partial query.

country string

The country the suggestions are for, in lower case.

language string

The language the suggestions are for.

suggestions string[]

The suggestions, in Google’s order.

Request

curl -X POST "https://api.fetchlayer.dev/google-search/autocomplete" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"fetchla"}'

Response

{
  "requestedUrl": "https://www.google.com/complete/search?q=fetchla&client=chrome&hl=en&gl=us",
  "scrapedAt": "2026-09-15T20:59:28.301Z",
  "transport": "google",
  "notes": [],
  "resultType": "autocomplete",
  "query": "fetchla",
  "country": "us",
  "language": "en",
  "suggestions": [
    "fetchlands",
    "fetchlands mtg",
    "fetchlands scryfall",
    "fetchland prices",
    "fetchlands list",
    "fetchlab",
    "fetchlayer",
    "fetchlands moxfield"
  ]
}