get_search_suggestions

What Google suggests as people type a phrase: up to ten completions, by country. ₹0.20 per call; a result that finds nothing is ₹0.

What it does

The completions Google offers as someone types a phrase into the search box: data.suggestions[] with one value per suggestion, usually up to ten, for a country (gl) and interface language (hl).

Use it to find the exact questions and long-tail phrases buyers type, for page briefs and FAQs; keyword_volume then sizes them, get_keyword_ideas gives related keywords with volumes, and get_search_page shows the questions Google lists under People also ask. Flat price per call; a phrase Google suggests nothing for is free. Under two seconds.

India: gl "in" and hl "en" or "hi"; the default is the United States and English.

Inputs

Generated from the contract captured from staging on 2026-11-19.

FieldTypeRequiredDescription
qstringyesThe phrase as someone starts typing it ("best crm for").
glstringnoCountry, two letters ("in" India, "us" United States). Default us.
hlstringnoInterface language, two letters ("en", "hi"). Default en.
locationstringnoOptional city or region by name ("Mumbai, Maharashtra, India").

What drives the cost

Flat price per call, up to about ten suggestions. An answer with no suggestions is free; Google suggests something for almost any text, so nearly every call is charged. A result that finds nothing is class: "ok_free", ₹0. The timeout is 30 seconds.

Price today

Price today₹0.20 per call (cost_paise: 20) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.38 (hold_paise: 38); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_search_suggestions"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_search_suggestions"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_search_suggestions","input":{"q":"predictive maintenance software","gl":"in","hl":"en"}}'

What comes back

data, as the live check of 2026-11-19 recorded it, trimmed:

{
  "suggestions": [
    {
      "value": "predictive maintenance software"
    },
    {
      "value": "predictive maintenance software companies"
    },
    {
      "value": "predictive maintenance software for manufacturing"
    }
  ]
}

Notes

  • Flat price per call, up to about ten suggestions. An answer with no suggestions is free; Google suggests something for almost any text, so nearly every call is charged.
  • Start the phrase the way a buyer would ("how to", "best", "vs") to see the questions people ask.
  • No volumes: pass the suggestions to keyword_volume for those.

Siblings

This page as Markdown: /docs/tools/get_search_suggestions.md. Something wrong or missing: hello@parel.si.