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.
| Field | Type | Required | Description |
|---|---|---|---|
q | string | yes | The phrase as someone starts typing it ("best crm for"). |
gl | string | no | Country, two letters ("in" India, "us" United States). Default us. |
hl | string | no | Interface language, two letters ("en", "hi"). Default en. |
location | string | no | Optional 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 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0 |
| Timeout | 30 s, then upstream_timeout (₹0, retryable) |
| Over MCP | run_tool with tool: "get_search_suggestions" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_search_suggestions" |
| Confirmation | not 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.