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

# Google Maps place

> Read a Google Maps place page as JSON with the google-maps-place parser. $1 per 1,000 calls. Send the page to scrape. Examples in cURL, TypeScript and Python.

Reads a Google Maps place page and returns one place as JSON.

## Make a request

Send the page's URL to [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md) with a `json` format that names the parser. Get an API key in the [Quickstart](https://docs.stophy.dev/quickstart).

```bash cURL theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0","formats":[{"type":"json","parser":"google-maps-place"}]}'
```

```typescript TypeScript theme={null}
const response = await fetch("https://api.stophy.dev/v1/scrape", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STOPHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0",
    formats: [{ type: "json", parser: "google-maps-place" }],
  }),
});
console.log(await response.json());
```

```python Python theme={null}
import os

import requests

response = requests.post(
    "https://api.stophy.dev/v1/scrape",
    headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
    json={
        "url": "https://www.google.com/maps/place/Eiffel+Tower/@48.8584,2.2945,17z/data=!3m1!4b1!4m6!3m5!1s0x47e66e2964e34e2d:0x8ddca9ee380ef7e0",
        "formats": [{"type": "json", "parser": "google-maps-place"}],
    },
)
print(response.json())
```

## Read the response

The parser's data is in `data.json`. Its fields include `id`, `url`, `name`, `categories`, `address`, `location`, `phone`, `website`, `description`, `rating`, `reviewCount`, `priceLevel`, `hours` and `images`. This sample is cut to the first items.

```json theme={null}
{
  "success": true,
  "data": {
    "json": {
      "id": "0x47e66e2964e34e2d:0x8ddca9ee380ef7e0",
      "url": "https://www.google.com/maps?cid=10222232094831998944",
      "name": "Eiffel Tower",
      "categories": [
        "Historical landmark",
        "Monument",
        "Tourist attraction"
      ],
      "address": "Av. Gustave Eiffel, 75007 Paris, France",
      "location": {
        "latitude": 48.858370099999995,
        "longitude": 2.2944812999999997
      },
      "phone": null,
      "website": "https://www.toureiffel.paris/fr",
      "description": "Gustave Eiffel's iconic, wrought-iron 1889 tower, with steps and elevators to observation decks.",
      "rating": 4.7,
      "reviewCount": 499973,
      "priceLevel": null,
      "hours": [
        {
          "days": "Thursday",
          "times": [
            "9 AM-12 AM"
          ]
        }
      ],
      "images": [
        "https://lh3.googleusercontent.com/grass-cs/AABkmLdQDdsOsH9WSc8SkiOuMHCC-IdIUZhRh4kDmNWte1b_k3tDK810QX1NVW0k5Y9n5sij1YH8…"
      ],
      "googlePlaceId": "ChIJLU7jZClu5kcR4PcOOO6p3I0",
      "photos": 1717839,
      "hoursToday": "9 AM-12 AM",
      "openStatus": "Closed · Opens 9 AM",
      "timezone": "Europe/Paris",
      "plusCode": "8FW4V75V+8Q",
      "reservationUrl": null,
      "attributes": [
        "Wheelchair accessible entrance",
        "Wheelchair accessible parking lot",
        "Wheelchair accessible restroom"
      ],
      "emails": [],
      "socials": [],
      "brand": null,
      "filledFrom": null
    }
  }
}
```

## Options

Send options in the `options` object of the `json` format.

| Option | What it does |
| - | - |
| `country` | ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted. |
| `language` | BCP 47 language tag, e.g. en or pt-BR. Any case is accepted. |

## Price

\$1 per 1,000 calls. See [Pricing](https://docs.stophy.dev/account/pricing.md).

## Limits and errors

* The URL must be a Google Maps place page. Any other URL fails with `invalidRequest`.
* The answer comes back in `data.json`. If the page cannot be read, the call fails with an error code from [Errors](https://docs.stophy.dev/api-reference/errors.md).

## Related

* [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers) lists every parser.
* [Scrape](https://docs.stophy.dev/scrape/overview) has the options every scrape takes.
* [Google Maps](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel/google-maps.md)
* [Google Maps reviews](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel/google-maps-reviews.md)
* [Google Patents](https://docs.stophy.dev/scrape/prebuilt-parsers/web/google-patents.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.