Google Maps Place Details API

The ScrapeMapsAPI Google Maps Place Details API returns what Google Maps shows about one place as JSON: name and categories, the address split into street, postal code, city and country, coordinates and plus code, phone in local and international format, website, weekly opening hours with every opening period, time zone, business status, rating and review count, attributes such as accessibility and service options, photos and booking links. Identify the place by place ID, CID or feature ID: one GET request, 1 credit.

No credit card needed. One API key works on every endpoint.

Quick example

GET/v1/places/{place}

Send your key in the X-API-Key header (or as Authorization: Bearer) to the base URL https://api.scrapemapsapi.com. The official SDKs wrap the same call: pip install scrapemapsapi or npm install scrapemapsapi.

curl "https://api.scrapemapsapi.com/v1/places/ChIJ8cLgoQNUKhMReGlaTjwrH40?language=en" \
  -H "X-API-Key: key_your_api_key"

Sample response

A successful call answers with HTTP 200: the place in data and the cost in meta.credits_used, always 1. Opening hours come both structured (periods of opening and closing times, 24-hour clock, local time) and as the text Google shows.

{
  "data": {
    "id": "ChIJ8cLgoQNUKhMReGlaTjwrH40",
    "ids": {
      "place_id": "ChIJ8cLgoQNUKhMReGlaTjwrH40",
      "cid": "10168894021638449528",
      "feature_id": "0x132a5403a1e0c2f1:0x8d1f2b3c4e5a6978",
      "google_maps_url": "https://www.google.com/maps?cid=10168894021638449528"
    },
    "name": "Trattoria Da Neri",
    "categories": [
      "Tuscan restaurant",
      "Italian restaurant"
    ],
    "address": {
      "formatted": "Via dei Neri, 42/r, 50122 Firenze FI, Italy",
      "street": "Via dei Neri, 42/r",
      "postal_code": "50122",
      "city": "Firenze",
      "region": "Toscana",
      "country_code": "IT"
    },
    "location": {
      "lat": 43.7681,
      "lng": 11.258
    },
    "rating": 4.6,
    "review_count": 2843,
    "phone": "055 123 4567",
    "website": "https://www.trattoriadaneri.example",
    "status": "operational",
    "local_name": null,
    "phone_international": "+39 055 123 4567",
    "plus_code": "8FMHQ753+6V",
    "timezone": "Europe/Rome",
    "description": "Family-run trattoria near Santa Croce serving bistecca alla fiorentina and handmade pasta.",
    "opening_hours": {
      "weekly": [
        {
          "day": "monday",
          "closed": false,
          "open_24h": false,
          "periods": [
            {
              "open": "12:00",
              "close": "15:00"
            },
            {
              "open": "19:00",
              "close": "22:30"
            }
          ],
          "text": "12:00–15:00, 19:00–22:30"
        },
        {
          "day": "tuesday",
          "closed": true,
          "open_24h": false,
          "periods": [],
          "text": "Closed"
        }
      ],
      "status_text": "Open · Closes 3 pm"
    },
    "attributes": {
      "Service options": [
        "Dine-in",
        "Takeaway"
      ],
      "Accessibility": [
        "Wheelchair-accessible entrance"
      ]
    },
    "photos": [
      {
        "url": "https://lh5.googleusercontent.com/p/AF1QipExample=w800-h600",
        "width": 800,
        "height": 600
      }
    ],
    "booking_links": [
      {
        "url": "https://www.thefork.example/trattoria-da-neri",
        "domain": "thefork.example"
      }
    ],
    "knowledge_graph_id": "/g/11c1q8_example"
  },
  "meta": {
    "credits_used": 1,
    "cached": true,
    "language": "en"
  }
}

Illustrative values for a fictional restaurant: a real response carries the live data of the place you ask for.

Response fields

FieldTypeDescription
idsobjectplace_id, cid, feature_id and google_maps_url of the place.
categoriesstring[]Categories, the main one first.
addressobjectformatted, street, postal_code, city, region and country_code.
locationobjectlat and lng.
plus_codestring | nullOpen Location Code of the place.
phone_internationalstring | nullPhone number in international format; phone has the local one.
websitestring | nullWebsite of the business.
timezonestring | nullIANA time zone, e.g. Europe/Rome.
statusstring | nulloperational, temporarily_closed or permanently_closed; null when Google does not say.
opening_hoursobject | nullweekly: one entry per day with closed, open_24h, periods (open and close, HH:MM) and text; plus status_text.
attributesobjectFeature groups, e.g. accessibility, service options, payments.
photosobject[]Photos of the place: url, width and height.
booking_linksobject[]Reservation and ordering links: url and domain.
descriptionstring | nullDescription written by the owner.

Parameters

ParameterInTypeDefaultDescription
placepathstringrequiredPlace ID (ChIJ…), CID (the digits of maps?cid= links) or feature ID (0x…:0x…). Any other format is refused with 400 invalid_place_id.
languagequerystringenLanguage of names, categories and opening hours text, e.g. en, de.
regionquerystringusTwo-letter country code used for the request, e.g. us.

Without a key the API answers 401 missing_api_key, with a wrong or disabled key 401 invalid_api_key, and with no credits left 402 insufficient_credits. When Google Maps cannot be reached the answer is 503 upstream_unavailable: retry in a minute. Errors are never billed, and every error code is documented.

What you get, and what you don't

The data is what Google Maps shows to a signed-out visitor, read live and cached for up to 7 days. Fields Google does not give without signing in, such as popular times and price level, are not in the schema rather than always empty.

A place that does not exist answers 404 place_not_found and costs nothing. To start from a link copied from Google Maps, including a maps.app.goo.gl short link, convert it with /v1/places/resolve first (1 credit).

Use cases

CRM and data enrichment

Complete your records with the phone, website, address and coordinates of each business, and keep them up to date with a periodic refresh.

Directories and listings

Fill the pages of a local directory or a travel guide with opening hours, categories, attributes and photos, in the language of your readers.

Opening hours and status checks

Detect when a place changes its hours or closes, temporarily or for good, before your customers find out the hard way.

Local and travel apps

Show whether a place is open now, how to reach it and whether it is wheelchair accessible, with the time zone to read the hours correctly.

Place details and the official Google Places API

Google's Place Details is billed by SKU, with a price that depends on the fields you ask for, and needs a Google Cloud project with billing enabled.

ScrapeMapsAPI returns every field in one call for a flat 1 credit: 1,000 places cost $3 at the list price and $1.50 with the largest credit pack, with no field masks to manage.

Pricing

Place details cost 1 credit per call, whatever fields the place has. Errors such as an unknown place are free, and the 200 free calls of every month cover 200 places.

  • 200 free calls every month, no credit card
  • Then $3 per 1,000 calls, down to $1.50 with credit packs
  • 1 credit per successful call; errors are free
  • Credits valid for 12 months from purchase, no subscription

See all prices and credit packs

Also in the MCP server for AI assistants

Ask your assistant “is this restaurant open on Sunday evening, and is it wheelchair accessible?” and it calls get_place, after resolve_place if you pasted a Google Maps link.

The MCP server gives Claude, Cursor and other MCP clients the same data as tools. Run it with uvx scrapemapsapi-mcp (or npx -y scrapemapsapi-mcp) with your API key in SCRAPEMAPSAPI_API_KEY; the MCP server guide has the setup for each client. Tool calls are billed like API calls.

Tools: get_place, resolve_place, get_reviews

Frequently asked questions

What does the place details response include?
Name, categories, structured address, coordinates, plus code, phone (local and international), website, time zone, business status, rating, review count, weekly opening hours, attributes, photos, booking links and the owner's description, plus the place ID, CID and feature ID.
How much does a place details call cost?
1 credit per successful call. Every account gets 200 free calls a month, then $3 per 1,000 calls, down to $1.50 with credit packs. Errors are free.
Which identifiers can I use?
A place ID (ChIJ…), a CID (the number in maps?cid= links) or a feature ID (0x…:0x…). The resolve endpoint converts any Google Maps URL, including maps.app.goo.gl short links.
Are popular times and price level available?
No. Google does not show them to signed-out visitors, so they are not part of the response.
Can I get the details in another language?
Yes: set language (e.g. it, de, pt-BR) for names, categories and the opening hours text. region sets the country used for the request.
How fresh is the data?
Details are read live from Google Maps and cached for up to 7 days; meta.cached tells you when a response came from the cache.

Start getting Google Maps place details

Create an account and get 200 free calls every month. Your first place is one quick start away.