# Google Search Autocomplete

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/search/autocomplete` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/google-search-autocomplete |

## Description

Retrieve real-time Google Search autocomplete suggestions for any query, with support for language and country localization.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/google/search/autocomplete' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Autocomplete 'coffee'. US/English

```json
{
  "suggestions": [
    {
      "value": "ryze mushroom coffee"
    },
    {
      "value": "coffee near me"
    },
    {
      "value": "mushroom coffee"
    },
    {
      "value": "keurig coffee maker"
    },
    {
      "value": "costa coffee"
    },
    {
      "value": "zus coffee"
    },
    {
      "value": "ninja coffee machine"
    },
    {
      "value": "black rifle coffee"
    },
    {
      "value": "delonghi coffee machine"
    },
    {
      "value": "coffee shops near me"
    }
  ],
  "search_parameters": {
    "q": "coffee",
    "cp": 0,
    "gl": "us",
    "hl": "en",
    "engine": "google",
    "google_domain": "google.com"
  }
}
```

### Autocomplete 'python'. France/French

```json
{
  "suggestions": [
    {
      "value": "python"
    },
    {
      "value": "monty python"
    },
    {
      "value": "anaconda python"
    },
    {
      "value": "python en ligne"
    },
    {
      "value": "spyder python"
    },
    {
      "value": "google colab python"
    },
    {
      "value": "python online"
    },
    {
      "value": "python download"
    },
    {
      "value": "colt python"
    },
    {
      "value": "python royal"
    }
  ],
  "search_parameters": {
    "q": "python",
    "cp": 0,
    "gl": "fr",
    "hl": "fr",
    "engine": "google",
    "google_domain": "google.com"
  }
}
```

### Autocomplete 'best laptop'. UK/English with cursor position

```json
{
  "suggestions": [
    {
      "value": "best laptops"
    },
    {
      "value": "best laptops 2025"
    },
    {
      "value": "best laptops 2026"
    },
    {
      "value": "best laptop for students"
    },
    {
      "value": "best laptop deals"
    },
    {
      "value": "best laptop deals uk"
    },
    {
      "value": "best laptops 2025 uk"
    },
    {
      "value": "best laptops under £500"
    },
    {
      "value": "best laptop for university students"
    },
    {
      "value": "best laptop brands"
    }
  ],
  "search_parameters": {
    "q": "best laptop",
    "cp": 10,
    "gl": "gb",
    "hl": "en",
    "engine": "google",
    "google_domain": "google.com"
  }
}
```

## Documentation

## Overview
Fetch Google's real-time autocomplete suggestions for any search query, with country and language targeting.

## Quickstart
```
POST https://api.piloterr.com/v2/google/search/autocomplete
Content-Type: application/json

{"query": "coffee", "gl": "us", "hl": "en"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The search query to autocomplete |
| `cp` | number | no | Cursor position in the query |
| `gl` | string | no | 2-letter country code |
| `hl` | string | no | 2-letter language code |

## Main use cases
- Power search-as-you-type features in content discovery tools
- Extract trending keyword variations for SEO content planning
- Build keyword research tools by collecting autocomplete suggestions at scale
- Identify regional search intent differences across locales