# Google API: Get search suggestions

> Gets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/google.com/get-search-suggestions
- Method: `google.com/get_search_suggestions`, version 1
- Website: google.com
- Returns: suggested search text, position, Google Search page URL
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `query` | string | yes | `"how to start a"` | Words typed so far, for example how to start a. |
| `country` | string | no |  | Country name or two-letter code, for example United States or US. Default "United States". |
| `language` | string | no |  | Language name or code, for example French or fr. Default "English". |
| `max_results` | integer | no |  | Most suggestions to return, for example 10. Default 10. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "query": "how to start a"
}
```

Its output:

```json
{
  "query": "how to start a",
  "suggestions": [
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+business&hl=en&gl=us",
      "position": 1,
      "suggested_search_text": "how to start a business"
    },
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+podcast&hl=en&gl=us",
      "position": 2,
      "suggested_search_text": "how to start a podcast"
    },
    {
      "page_url": "https://www.google.com/search?q=how+to+start+a+jam+on+spotify&hl=en&gl=us",
      "position": 3,
      "suggested_search_text": "how to start a jam on spotify"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"google.com/get_search_suggestions","input":{"query":"how to start a"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What autocomplete suggestions does Google show when I type best running sh in the US in English?
- Give me the top 8 Google search completions for healthy breakfast ideas for kids, in French for France.
- I need up to 15 suggested searches Google offers for cheap flights to, limited to Germany and German.
- Pull Google's autocomplete list for how to fix a leaky fa in Canada, English, max 5 results.
- Which search phrases does Google suggest after typing python list comp, for users in Japan in Japanese?

## Input schema

```json
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words typed so far, for example how to start a."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or US."
    },
    "language": {
      "type": "string",
      "default": "English",
      "description": "Language name or code, for example French or fr."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "Most suggestions to return, for example 10."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "query",
    "suggestions"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Words used to request suggestions."
    },
    "suggestions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "suggested_search_text",
          "page_url"
        ],
        "properties": {
          "page_url": {
            "type": "string",
            "description": "Google Search page for this suggestion."
          },
          "position": {
            "type": "integer",
            "description": "Rank in the suggestion list, starting at 1."
          },
          "suggested_search_text": {
            "type": "string",
            "description": "Suggested search words."
          }
        }
      },
      "description": "Autocomplete suggestions in Google order."
    }
  }
}
```

## See more

- [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.
- [Google API: Search Chrome extensions](https://fous.com/methods/chromewebstore.google.com/search-extensions.md): Finds Chrome Web Store extensions by keywords in store order, with each listing's developer, users, rating, rating count, short description and store link. Some listings omit developer, users or ratings.
- [Google API: Search Google News](https://fous.com/methods/news.google.com/search-news.md): Finds recent Google News articles about a company, person or topic for a country and language, in Google News order, optionally within a time window, with each article's publisher link resolved.
- [Google API: Get interest by region](https://fous.com/methods/trends.google.com/get-interest-by-region.md): Shows where a search term has the highest relative Google Trends interest, by country worldwide or by region within a country. Scores run from 0 to 100.
- [Google API: List trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.
- [Google API: Search places](https://fous.com/methods/google.com/search-places.md): Finds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown.
- [Google API: Get related searches](https://fous.com/methods/trends.google.com/get-related-searches.md): Returns top and rising related searches and topics for a term on Google Trends, for a country or US state and time range.
- [Google API: Get place reviews](https://fous.com/methods/google.com/get-place-reviews.md): Finds a place on Google Maps by name and location and returns its public reviews in the chosen order.
- [All Google methods](https://fous.com/methods/google.com.md)