# 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.
**Pricing**
* We charge 5 credits per Google Autocomplete API request.
{% hint style="danger" %}
Requires authentication
{% endhint %}
`POST` `https://api.serphouse.com/google-autocomplete-api`
#### Headers
| Name | Type | Description |
| ----------------------------------------------- | ------ | ------------------------ |
| Authorization\* | String | Bearer \ |
| Content-Type\* | String | application/json |
#### Request Body
| Name | Type | Description |
|---|
| q* | string | Search phrase that you want to search |
| lang* | string | You can set language for e.g. en for english fr for french.
Get the list of available languages by making a separate request to the List of Language |
| loc* | string | Specifies the location to retrieve localized autocomplete suggestions.
You can receive the list of available locations of search engines with their loc_id by making a separate request to the List of Locations |
| client | string | Defines the client environment used to fetch Google autocomplete suggestions from different browsers or services.
chrome (default) - used for Chrome browser searches.chrome-omni - used for Chrome address bar.home_page - used for Chrome Google homepage.safari - used when Google is opened in Safari browserfirefox - used for Firefox browser searches.youtube - origin unknown.
|
{% tabs %}
{% tab title="200: OK" %}
```json
{
"status": "error",
"msg": "Please try again",
"error": ""
}
```
{% endtab %}
{% tab title="200: OK" %}
```json
{
"status": "success",
"msg": "Completed",
"results": {
"search_metadata": {
"id": 230200211,
"status": "success",
"created_at": "2026-03-16T11:52:50.000000Z",
"processed_at": "2026-03-16 11:52:50"
},
"search_parameters": {
"q": "football",
"url": "https://www.google.com/complete/search?q=football&client=chrome&dpr=1&hl=en&gl=US",
"client": "chrome",
"lang": "en",
"country": "US",
"location": "Abernathy,Texas,United States"
},
"results": {
"suggestions": [
{
"value": "football games today",
"relevance": 1250,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+games+today"
},
{
"value": "football games",
"relevance": 701,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+games"
},
{
"value": "football today",
"relevance": 700,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+today"
},
{
"value": "football tonight",
"relevance": 601,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+tonight"
},
{
"value": "football game tonight",
"relevance": 600,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+game+tonight"
},
{
"value": "football scores",
"relevance": 559,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+scores"
},
{
"value": "football games this weekend",
"relevance": 558,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+games+this+weekend"
},
{
"value": "football games tomorrow",
"relevance": 557,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+games+tomorrow"
},
{
"value": "football schedule",
"relevance": 556,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+schedule"
},
{
"value": "football playoffs",
"relevance": 555,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+playoffs"
},
{
"value": "football on tv today",
"relevance": 554,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+on+tv+today"
},
{
"value": "football games today on tv",
"relevance": 553,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+games+today+on+tv"
},
{
"value": "football cleats",
"relevance": 552,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+cleats"
},
{
"value": "football bros",
"relevance": 551,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+bros"
},
{
"value": "football tomorrow",
"relevance": 550,
"type": "QUERY",
"link": "https://www.google.com/search?q=football+tomorrow"
}
],
"verbatim_relevance": 1300
}
}
}
```
{% endtab %}
{% tab title="400: Bad Request " %}
```json
{
"status": "error",
"msg": "validation_error",
"error": {
"q": [
"The q field is required."
]
}
}
```
{% endtab %}
{% tab title="402: Payment Required" %}
```json
{
"status": "error",
"msg": "Your SERPHouse account has either run out of available credits (try upgrading your Plan), or there is a payment problem.",
"error": ""
}
```
{% endtab %}
{% tab title="400: Bad Request " %}
```json
{
"status": "error",
"msg": "Missing required fields.",
"error": ""
}
```
{% endtab %}
{% tab title="401: Unauthorized" %}
```json
{
"status": "error",
"msg": "Unauthenticated"
}
```
{% endtab %}
{% endtabs %}
## Example request:
{% tabs %}
{% tab title="BASH" %}
curl --location --request POST 'https://api.serphouse.com/google-autocomplete-api' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client": "chrome"
}
}'
{% endtab %}
{% tab title="RUBY" %}
```ruby
require "uri"
require "json"
require "net/http"
url = URI("https://api.serphouse.com/google-autocomplete-api")
https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer "
request.body = JSON.dump({
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client": "chrome"
}
})
response = https.request(request)
puts response.read_body
```
{% endtab %}
{% tab title="PYTHON" %}
```python
import requests
import json
url = "https://api.serphouse.com/google-autocomplete-api"
payload = json.dumps({
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client": "chrome"
}
})
headers = {
'Authorization': 'Bearer ',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
```
{% endtab %}
{% tab title="NODE.JS" %}
```javascript
var axios = require('axios');
var data = JSON.stringify({
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client":"chrome"
}
});
var config = {
method: 'post',
url: 'https://api.serphouse.com/google-autocomplete-api',
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer '
},
data : data
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});
```
{% endtab %}
{% tab title="JAVA" %}
```java
OkHttpClient client = new OkHttpClient().newBuilder().build();
MediaType mediaType = MediaType.parse("application/json");
JSONObject jsonObject = new JSONObject();
JSONObject dataObject = new JSONObject();
dataObject.put("q", "football");
dataObject.put("lang", "en");
dataObject.put("loc", "Abernathy,Texas,United States");
dataObject.put("client", "chrome");
jsonObject.put("data", dataObject);
String bodyJson = jsonObject.toString();
RequestBody body = RequestBody.create(mediaType,bodyJson);
Request request = new Request.Builder()
.url("https://api.serphouse.com/google-autocomplete-api")
.method("POST", body)
.addHeader("Content-Type", "application/json")
.addHeader("Authorization", "Bearer ")
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());git
```
{% endtab %}
{% tab title="JAVASCRIPT" %}
```javascript
var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer ");
myHeaders.append("Content-Type", "application/json");
var raw = JSON.stringify({
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client":"chrome"
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("https://api.serphouse.com/google-autocomplete-api", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));
```
{% endtab %}
{% tab title="GO" %}
```go
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.serphouse.com/google-autocomplete-api"
method := "POST"
payload := strings.NewReader(`{
"data": {
"q": "football",
"lang": "en",
"loc": "Abernathy,Texas,United States",
"client":"chrome"
}
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Authorization", "Bearer ")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
```
{% endtab %}
{% tab title="C#/.NET" %}
```csharp
var client = new RestClient("https://api.serphouse.com/google-autocomplete-api");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer ");
var body = @"{
""data"": {
""q"": ""football"",
""lang"": ""en"",
""loc"": ""Abernathy,Texas,United States"",
""client"": ""chrome""
}
}";
request.AddParameter("application/json", body, ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
```
{% endtab %}
{% endtabs %}
[^1]:
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.serphouse.com/google-apis/google-autocomplete-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.