Google Suggest

Web Scraping API Google Suggest Target

The google_suggest target is built to obtain Google search term suggestions.

📘
Useful Links

This target is available with Web API Advanced plans.

Real-time and Asynchronous integration methods are available for this template

Batch requests are also supported.

Input Parameters

Request parameters available for the Google Suggest target:

Parameter	Type	Required	Description
`target`	string	✅	Target type must be set to `google_search`.
`query`	string	✅	Search query.
`geo`	string		Set the country to use when submitting the query. Full list of locations available for the Advanced plan can be found here.
`locale`	string		Set the value to change your Google search page web interface language. Read more.
`device_type`	string		Specify device type and browser. Read more.

Request Examples

curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/scrape' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic TOKEN VALUE' \ // update with your authorization token
        --header 'Content-Type: application/json' \
        --data '
    {
      "target": "google_suggest",
      "query": "pizza"
    }
'


const scrape = async() => {
  const response = await fetch("https://scraper-api.decodo.com/v2/scrape", {
    method: "POST",
    body: JSON.stringify({
      "target": "google_suggest",
      "query": "pizza"
    }),
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Basic TOKEN VALUE" // update with your authorization token
    },
  }).catch(error => console.log(error));

  console.log(await response.json())
}

scrape()

import requests
  
url = "https://scraper-api.decodo.com/v2/scrape"
  
payload = {
      "target": "google_suggest",
      "query": "pizza"
}
  
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Basic TOKEN VALUE" # update with your authorization token
}
  
response = requests.post(url, json=payload, headers=headers)
  
print(response.text)

Output

Respone Example

{
  "results": [
      {
          "content": "[\"pizza\",[\"pizza hut\",\"pizza manta\",\"pizza hut manta\",\"pizza near me\",\"pizza dominos\",\"pizza hut ecuador\",\"pizza hut trabaja con nosotros\",\"pizza napolitana\",\"pizza hawaiana\",\"pizza margherita\",\"pizza dough recipe\",\"pizza hut menu\",\"pizza hut near me\",\"pizza papa johns\",\"pizza tower\"],[\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\",\"\"],[],{\"google:clientdata\":{\"bpc\":false,\"tlw\":false},\"google:suggestrelevance\":[1151,1150,601,600,560,559,558,557,556,555,554,553,552,551,550],\"google:suggestsubtypes\":[[512],[512,402],[512],[512],[512],[512],[512],[512],[512],[512],[512],[512],[512],[512],[512]],\"google:suggesttype\":[\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\",\"QUERY\"],\"google:verbatimrelevance\":1300}]",
          "headers": {},
          "status_code": 200,
          "query": "pizza",
          "task_id": "7397187570888616961",
          "created_at": "2025-11-20 08:22:29",
          "updated_at": "2025-11-20 08:22:34"
      }
  ]
}

Support

Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.

Updated about 22 hours ago