> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Maps Search API
The Google Maps Search API allows users to search for locations using keyword, coordinates, and various filters. The API returns relevant location details and map data.
## Get Your API Key
Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.
## Request Cost and API Credits
Each request to the Google Maps Search API consumes **API Credits** from your account balance.
* **Cost per request:** 5 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
**Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).
## Make Your First Request
```bash cURL theme={null}
curl --request GET -G \
--url 'https://api.hasdata.com/scrape/google-maps/search' \
--data-urlencode 'q=Pizza' \
--data-urlencode 'll=@40.7455096,-74.0083012,14z' \
--header 'Content-Type: application/json' \
--header 'x-api-key: '
```
```bash HasData CLI theme={null}
hasdata google-maps \
--q Pizza \
--ll '@40.7455096,-74.0083012,14z'
```
```javascript Node.js theme={null}
const axios = require('axios').default;
const options = {
method: 'GET',
url: 'https://api.hasdata.com/scrape/google-maps/search',
params: {q: 'Pizza', ll: '@40.7455096,-74.0083012,14z'},
headers: {'Content-Type': 'application/json', 'x-api-key': ''}
};
try {
const { data } = await axios.request(options);
console.log(data);
} catch (error) {
console.error(error);
}
```
```python Python theme={null}
import requests
url = "https://api.hasdata.com/scrape/google-maps/search"
querystring = {"q":"Pizza","ll":"@40.7455096,-74.0083012,14z"}
headers = {
"Content-Type": "application/json",
"x-api-key": ""
}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())
```
```php PHP theme={null}
"Pizza",
"ll" => "@40.7455096,-74.0083012,14z",
];
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.hasdata.com/scrape/google-maps/search?" . http_build_query($params),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: ",
],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
```java Java theme={null}
OkHttpClient client = new OkHttpClient();
HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/google-maps/search")
.newBuilder()
.addQueryParameter("q", "Pizza")
.addQueryParameter("ll", "@40.7455096,-74.0083012,14z")
.build();
Request request = new Request.Builder()
.url(url)
.get()
.addHeader("Content-Type", "application/json")
.addHeader("x-api-key", "")
.build();
Response response = client.newCall(request).execute();
```
```csharp C# theme={null}
using System.Net.Http;
using System.Web;
var client = new HttpClient();
var query = HttpUtility.ParseQueryString(string.Empty);
query["q"] = "Pizza";
query["ll"] = "@40.7455096,-74.0083012,14z";
var url = $"https://api.hasdata.com/scrape/google-maps/search?{query}";
var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "");
using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
uri = URI("https://api.hasdata.com/scrape/google-maps/search")
params = {
"q" => "Pizza",
"ll" => "@40.7455096,-74.0083012,14z",
}
uri.query = URI.encode_www_form(params)
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = ''
response = http.request(request)
puts response.read_body
```
```rust Rust theme={null}
use reqwest::blocking::Client;
fn main() -> Result<(), Box> {
let client = Client::new();
let res = client
.get("https://api.hasdata.com/scrape/google-maps/search")
.query(&[("q", "Pizza")])
.query(&[("ll", "@40.7455096,-74.0083012,14z")])
.header("Content-Type", "application/json")
.header("x-api-key", "")
.send()?
.text()?;
println!("{}", res);
Ok(())
}
```
```go Go theme={null}
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
params := url.Values{}
params.Set("q", "Pizza")
params.Set("ll", "@40.7455096,-74.0083012,14z")
u := "https://api.hasdata.com/scrape/google-maps/search?" + params.Encode()
req, _ := http.NewRequest("GET", u, nil)
req.Header.Add("Content-Type", "application/json")
req.Header.Add("x-api-key", "")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
```
## API Parameters
| Parameter | Default Value | Required | Description |
| --------- | --------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q` | Pizza | Yes | Search query term or phrase. |
| `domain` | - | No | Google domain to use. Default is google.com. |
| `gl` | - | No | The two-letter country code for the country you want to limit the search to. |
| `hl` | - | No | The two-letter language code for the language you want to use for the search. |
| `start` | - | No | Specifies the result offset for pagination purposes. The offset dictates the number of rows to skip from the beginning of the results. This is useful for accessing subsequent pages of search results. For example, an offset of 0 (the default value) returns the first page of results, 20 returns the second page, 40 returns the third page, and so on. This parameter is especially relevant when used in conjunction with the 'll' parameter for location-based searches.
|
| `ll` | @40.7455096,-74.0083012,14z | No | GPS coordinates of the location where the search query is to be performed. This parameter is required if the 'start' parameter is present. The format for the `ll` parameter is `@` followed by latitude, longitude, and zoom level, separated by commas. The latitude and longitude should be in decimal degrees, and the zoom level is an integer. Example: `@40.7455096,-74.0083012,14z`.
|