# Google Autocomplete API (/docs/google-apis/google-autocomplete-api)





Retrieve real-time Google search suggestions (autocomplete results) using the Google Auto Complete API. This endpoint returns keyword suggestions exactly like those shown in the Google search bar while typing a query.

<Callout type="info">
  **Pricing:** 5 credits per Google Autocomplete API request.
</Callout>

<Callout type="warn">
  Requires authentication → provide your API key as a Bearer token in the
  Authorization header.
</Callout>

`POST` `https://api.serphouse.com/google-autocomplete-api`

## Headers [#headers]

| Name                                                           | Type   | Description             |
| -------------------------------------------------------------- | ------ | ----------------------- |
| Authorization <span style="{color: &#x22;red&#x22;}">\*</span> | String | Bearer `<YOUR_API_KEY>` |
| Content-Type <span style="{color: &#x22;red&#x22;}">\*</span>  | String | application/json        |

## Request Body [#request-body]

| Name                                               | Type   | Description                                                                                                                                                                               |
| -------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| q <span style="{color: &#x22;red&#x22;}">\*</span> | string | Search phrase that you want to search                                                                                                                                                     |
| lang                                               | string | You can set language for e.g. `en` for english `fr` for french.<br />Get the list of available languages by making a separate request to the [Languages List](/extra-apis/languages-list) |
| loc                                                | string | Location for localized suggestions<br />You can receive the list of available locations by making a separate request to the [Locations List](/extra-apis/locations-list)                  |
| client                                             | string | `chrome` (default), `chrome-omni`, `home_page`, `safari`, `firefox`, `youtube`                                                                                                            |

## Example Request [#example-request]

<ApiExample endpoint="https://api.serphouse.com/google-autocomplete-api" query="coffee" lang="en" params="{&#x22;loc&#x22;: &#x22;Abernathy,Texas,United States&#x22;, &#x22;client&#x22;: &#x22;chrome&#x22;}" />

## Example Response [#example-response]

<ApiExample mode="response">
  <ApiTab label="JSON" response="googleAutocompleteJsonResponse" />
</ApiExample>

## Related Links [#related-links]

<Cards>
  <Card title="Google Search API" href="/google-apis/google-search-api" />

  <Card title="Google Forums API" href="/google-apis/google-forums-api" />
</Cards>