> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_search_suggestions

# 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`](https://parel.si/docs/tools/keyword_volume.md) then sizes them, [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md) gives related keywords with volumes, and [`get_search_page`](https://parel.si/docs/tools/get_search_page.md) 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

```bash
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:

```json
{
  "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

- [`keyword_volume`](https://parel.si/docs/tools/keyword_volume.md)
- [`get_keyword_ideas`](https://parel.si/docs/tools/get_keyword_ideas.md)
- [`get_search_page`](https://parel.si/docs/tools/get_search_page.md)
