> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Maps places

> Search Google Maps for places matching a query and get back name, address, rating, review count, phone, website, and coordinates.

Search Google Maps for places matching a query and get back name, address, rating, review count, phone, website, and coordinates.

<Note>Use when you need local businesses or points of interest, lead lists for a city or area, or place details like ratings and contact info.</Note>

## Price

**\$0.0090 per place.** That is the rate you pay for each place the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer places costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field           | Type                                                        | Required | Notes                                                                                                                                                                                                                                                                                                                                                       |
| --------------- | ----------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `city`          | `string`                                                    |          | City to search in, e.g. Pittsburgh. Do not put the state or country here, they have their own fields.                                                                                                                                                                                                                                                       |
| `state`         | `string`                                                    |          | State or region. Mostly useful for US addresses.                                                                                                                                                                                                                                                                                                            |
| `county`        | `string`                                                    |          | County, regional district or departement, depending on the country.                                                                                                                                                                                                                                                                                         |
| `website`       | `allPlaces`, `withWebsite`, `withoutWebsite`                |          | Keep only places that have a website, or only those that do not. COSTS EXTRA: \$0.001 per place, as one search filter.                                                                                                                                                                                                                                      |
| `language`      | `string`                                                    |          | Defaults to `"en"`.                                                                                                                                                                                                                                                                                                                                         |
| `placeIds`      | `array`                                                     |          | Google place IDs, in the form ChIJreV9aqYWdkgROM\_boL6YbwA. One place, and one billed place, per ID.                                                                                                                                                                                                                                                        |
| `maxImages`     | `integer`                                                   |          | Additional images per place. 0 returns none, 99999 returns all. COSTS EXTRA: $0.0005 per image, plus $0.002 per place for the detail page images force open.                                                                                                                                                                                                |
| `startUrls`     | `array`                                                     |          | Google Maps URLs to scrape directly instead of searching. Place, search-results, cid and goo.gl/maps links all work. Each entry is an object with a url. Max 300 places per search URL.                                                                                                                                                                     |
| `maxReviews`    | `integer`                                                   |          | Reviews per place. 0 returns none, 99999 returns all. PERSONAL DATA: each review carries its author unless you set scrapeReviewsPersonalData false. COSTS EXTRA: $0.0005 per review, plus $0.002 per place for the detail page reviews force open. A large number here cannot push the bill past this call's ceiling, it just means fewer places come back. |
| `postalCode`    | `string`                                                    |          | One postal code to search in. Combine it with countryCode, never with city.                                                                                                                                                                                                                                                                                 |
| `countryCode`   | `string`                                                    |          | Two-letter country to search in, e.g. us, gb, de. These five location fields are more reliable than packing everything into locationQuery.                                                                                                                                                                                                                  |
| `reviewsSort`   | `newest`, `mostRelevant`, `highestRanking`, `lowestRanking` |          | Order reviews are collected in. The actor uses newest when you leave it out.                                                                                                                                                                                                                                                                                |
| `maxQuestions`  | `integer`                                                   |          | Questions and answers per place. 0 returns only the first pair, 999 returns all. PERSONAL DATA: the answers carry the asker's and the answerer's names. COSTS EXTRA: \$0.002 per place.                                                                                                                                                                     |
| `locationQuery` | `string`                                                    |          | Where to search, e.g. "Berlin, Germany"                                                                                                                                                                                                                                                                                                                     |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"maps.places","input":{"searchStringsArray":["example"],"maxCrawledPlacesPerSearch":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "lat": 44.4322,
  "lng": 26.0993,
  "url": "https://maps.google.com/?cid=123",
  "name": "Sam Okafor",
  "phone": "+1 555 0100",
  "rating": 4.6,
  "address": "Strada Lipscani 9, Bucharest",
  "website": "https://origocoffee.ro",
  "reviews_count": 2731
}
```