# Google Local API

> Search local businesses on Google by keyword and location, with name, rating, reviews, address, hours, phone and place ID.

Source: https://www.sandbase.ai/apis/google/local
API reference: https://www.sandbase.ai/apis/google/local#api

## Facts

- Provider: Google
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google/local`
- Price: $0.01 per call
- Capabilities: api, google, local, serp
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google/local` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `q` | string | yes |  |
| `location` | string | no |  |
| `uule` | string | no |  |
| `google_domain` | string | no |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `ludocid` | string | no |  |
| `tbs` | string | no |  |
| `start` | string | no |  |
| `device` | string | no |  |
| `json_restrictor` | string | no |  |

## FAQ

### How do I use the Google Local API?

Send a POST request to https://api.sandbase.ai/v1/api/google/local with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Local API cost?

$0.01 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Local API accept?

Required: q (string). Optional: location (string), uule (string), google_domain (string), gl (string), hl (string) and ludocid (string) and 4 more. The Parameters table and the Playground on this page list every field.

### What does the Google Local API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google developer account or API key?

No. Google Local runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google API access separately.

## README

### Google Local

Search local businesses on Google by keyword and location, with name, rating, reviews, address, hours, phone and place ID.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google/local" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "coffee", "location": "Austin, Texas, United States"}'
```

The result is returned in `outputs[0].data` as structured JSON.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `q` | string | Yes | Parameter defines the query you want to search. You can use anything that you would use in a regular Google Local search. |
| `location` | string | No | Parameter defines from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json API if you need more precise control. The `location` and `uule` p |
| `uule` | string | No | Parameter is the Google encoded location you want to use for the search. `uule` and `location` parameters can't be used together. For consistent results with coordinates-based `uule` parameter, a matching `gl` parameter is required. Head to |
| `google_domain` | string | No | Parameter defines the Google domain to use. It defaults to `google.com`. Head to the Google domains for a full list of supported Google domains. |
| `gl` | string | No | Parameter defines the country to use for the Google Local search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google countries for a full list of supported Goog |
| `hl` | string | No | Parameter defines the language to use for the Google Local search. It's a two or three-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French), optionally followed by a two-letter or three-digit region code (e.g |
| `ludocid` | string | No | Parameter defines the Google CID (customer identifier) of a place. This parameter can be found in Google Local API and Google Search API local results under the name of `place_id`, as well as in Google Maps API local results under the name  |
| `tbs` | string | No | (to be searched) parameter defines advanced search parameters that aren't possible in the regular query field. |
| `start` | string | No | Parameter defines the result offset. It skips the given number of results. It's used for pagination. The value depends on the number of results returned which can either be `10` or `20`. For eg, on mobile `10` results are returned, so `star |
| `device` | string | No | Parameter defines the device to use to get the results. It can be set to `desktop` (default) to use a regular browser, `tablet` to use a tablet browser (currently using iPads), or `mobile` to use a mobile browser. |
| `json_restrictor` | string | No | Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details. |

#### Pricing

$0.010 per successful call. Failed calls are not charged.