Skip to content
Google Maps

Get a place

One place's page on Google Maps, by its id, its link or its name, with everything places/search gives and its photos.

google_maps/places/get1 credit a callv2.0.1

When to use it

You want one place, given as place: an id (a search's id, a cid, a feature id), the link of its Google Maps page, or a name with its city ("Le Vieux Lyon, Lyon"). It costs 1 credit where a search costs 20: the cheap way from a name to a place id, before google_maps/reviews/list. A name that matches several places answers ambiguous_query with them.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
The place, however you know it: its Google place id (ChIJ..., a search's id), its cid (ids.cid), its feature id (ids.feature_id, 0x...:0x...), the link of its page on Google Maps as the browser shows it (a short maps.app.goo.gl link is not taken: open it and copy the page's link), or its name with its city as you would search it in Google Maps ("Le Vieux Lyon, Lyon"), for the place Google opens.
The language of names, categories, hours and labels, as an ISO 639-1 code.
The country Google answers for, as an ISO 3166-1 alpha-2 code in lower case.
1 credit a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "google_maps",
    "operation": "places/get",
    "options": {
      "place": "ChIJ39Y-tdg1fYcRQcZcBb499do"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_uldjjga7iuevsmcxivhhntsolu",
  "livemode": true,
  "source": "google_maps",
  "operation": "places/get",
  "version": "2.0.1",
  "schema_url": "https://api.lobstr.io/v2/catalog/google_maps/places/get",
  "options": {
    "place": "ChIJ39Y-tdg1fYcRQcZcBb499do"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": false,
  "next": null,
  "cost": {
    "credits": 1
  },
  "results": [
    {
      "object": "place",
      "id": "ChIJAAAAAAAAAAAAAAAAAAAAAAA",
      "name": "Acme Bistro",
      "categories": [
        "French restaurant"
      ],
      "primary_category_id": "french_restaurant",
      "result_type": "restaurant",
      "address": {
        "full": "1 Rue Exemple, 69005 Lyon, France",
        "street": "1 Rue Exemple",
        "neighborhood": null,
        "city": "Lyon",
        "postal_code": "69005",
        "state": null,
        "country_code": "FR"
      },
      "location": {
        "latitude": 45.7623,
        "longitude": 4.8275
      },
      "phone": "+33400000000",
      "website_url": "https://acme-bistro.example",
      "rating": {
        "value": 4.5,
        "scale": 5,
        "count": 1280,
        "distribution": {
          "1": 20,
          "2": 15,
          "3": 60,
          "4": 285,
          "5": 900
        }
      },
      "review_topics": [
        {
          "name": "pleasant waiters",
          "mentions": 147,
          "id": "FO2H9hrwgQQ"
        },
        {
          "name": "shared mezze",
          "mentions": 45,
          "id": "sA6lbPK32pE"
        }
      ],
      "description": "Local food and wine in vintage surrounds",
      "owner_description": "A family bistro since 1987, open for lunch and dinner every day but Sunday.",
      "booking_url": "https://acme-bistro.example/booking",
      "hours": [
        {
          "day": "monday",
          "intervals": [
            {
              "open": "11:30",
              "close": "14:30"
            },
            {
              "open": "18:30",
              "close": "22:00"
            }
          ]
        },
        {
          "day": "tuesday",
          "intervals": []
        }
      ],
      "more_hours": [
        {
          "label": "Kitchen",
          "hours": [
            {
              "day": "monday",
              "intervals": [
                {
                  "open": "12:00",
                  "close": "14:00"
                }
              ]
            }
          ]
        }
      ],
      "timezone": "Europe/Paris",
      "attributes": [
        {
          "id": "has_wheelchair_accessible_entrance",
          "label": "Wheelchair-accessible entrance",
          "group": "accessibility",
          "value": true
        }
      ],
      "highlights": [
        {
          "id": "lgbtq_friendly",
          "label": "LGBTQ+ friendly"
        }
      ],
      "actions": [
        {
          "type": "reserve",
          "label": "Reserve a table",
          "url": "https://www.google.com/maps/reserve/v/dine/c/AAAAAAAAAAA?source=pa&hl=en",
          "providers": [
            {
              "name": "Acme Bookings",
              "domain": "acme-bookings.example",
              "url": "https://acme-bookings.example/r/1"
            }
          ]
        }
      ],
      "owner": {
        "id": "100000000000000000000",
        "name": "Acme Bistro (Owner)"
      },
      "popular_times": null,
      "admission": {
        "price": {
          "amount": null,
          "currency": null,
          "text": "Free"
        },
        "url": "https://www.nps.gov/moru",
        "domain": "nps.gov",
        "offers": []
      },
      "hotel": null,
      "things_to_do": [
        {
          "title": "Mount Rushmore guided tour",
          "url": "https://tours.example/rushmore",
          "seller": "Tours Example",
          "price": {
            "amount": 79,
            "currency": "USD",
            "text": "US$79"
          },
          "duration": "3h",
          "rating": {
            "value": 4.8,
            "scale": 5,
            "count": 120
          }
        }
      ],
      "ids": {
        "place_id": "ChIJAAAAAAAAAAAAAAAAAAAAAAA",
        "cid": "1000000000000000000",
        "feature_id": "0x47f4000000000000:0x0de0b6b3a7640000",
        "kgmid": "/g/11aaaaaaaa"
      },
      "photo_url": "https://lh3.googleusercontent.com/example.jpg",
      "url": "https://www.google.com/maps/search/?api=1&query=45.7623%2C4.8275&query_place_id=ChIJAAAAAAAAAAAAAAAAAAAAAAA",
      "source_url": "https://www.google.com/maps?cid=15777584755905447489",
      "observed_at": "2026-10-26T09:00:00Z",
      "photos": [
        {
          "url": "https://lh3.googleusercontent.com/example",
          "width": 4032,
          "height": 3024
        }
      ],
      "related": [
        {
          "label": "Parks",
          "feature_ids": [
            "0x877d350066267d1d:0x1e0b44b09b8cb53"
          ]
        }
      ],
      "inside": [
        {
          "name": "Gift Shop",
          "feature_id": "0x877d35d9c6ba6043:0x4b81ad8ccee00f61",
          "kgmid": "/g/11c3tg91cl",
          "location": {
            "latitude": 43.8762633,
            "longitude": -103.4551644
          }
        }
      ]
    }
  ]
}

Options

placestringrequired
The place, however you know it: its Google place id (ChIJ..., a search's id), its cid (ids.cid), its feature id (ids.feature_id, 0x...:0x...), the link of its page on Google Maps as the browser shows it (a short maps.app.goo.gl link is not taken: open it and copy the page's link), or its name with its city as you would search it in Google Maps ("Le Vieux Lyon, Lyon"), for the place Google opens. A name Google answers with several places answers ambiguous_query with the first ones (free): send the one you mean.
languagestringDefault en
The language of names, categories, hours and labels, as an ISO 639-1 code.
countrystringDefault us
The country Google answers for, as an ISO 3166-1 alpha-2 code in lower case.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
The kind of record: a place, whichever site it comes from.
idstring
Google's place id (ChIJ...), stable across languages; repeated in ids.place_id.
namestring
categorieslist
As Google Maps names them, the main one first.
primary_category_idstring
The main category's id as Google files it, the same in every language: lebanese_restaurant, sewing_machine_store, cosmetic_dentist. Google gives it on a place's page for the main category alone; categories has every category's name, in the search's language.
result_typestring
Google's search-result type for the place, the same in every language: a family for most places (shopping, industrial, personal_care), finer for some (french_restaurant, bakery, park). Not its category: categories has those by name, and places/get gives primary_category_id.
address.fullstring
address.streetstring
address.neighborhoodstring
The district Google files the place under: Manhattan.
address.citystring
address.postal_codestring
address.statestring
The state or region, where the address has one: New York.
address.country_codestring
ISO 3166-1 alpha-2
location.latitudefloat
Degrees, 7 decimals (about a centimetre).
location.longitudefloat
Degrees, 7 decimals.
phonestring
E.164; null when Google gives no international number.
website_urlstring
rating.valuefloat
rating.scalefloat
The best possible value: ratings from other sites compare once divided by it.
rating.countinteger
rating.distribution.1integer
rating.distribution.2integer
rating.distribution.3integer
rating.distribution.4integer
rating.distribution.5integer
review_topicslist
The topics Google draws from the reviews (pleasant waiters), how many reviews mention each, and the id Google filters the reviews by; null when the answer has none (a list of results).
descriptionstring
Google's short summary of the place, when it has one.
owner_descriptionstring
What the place says of itself on its profile, as its owner wrote it (From the owner); null when it says nothing.
booking_urlstring
hourslist
The week, Monday first, in local time (timezone). A day closed has no interval; intervals: null is a day Google gives in a shape we cannot read (unknown, never closed); a close earlier than its open ends the next day; null when Google shows no hours.
more_hourslist
Hours of a service apart from the place's own (Kitchen, Brunch, Takeout...), labelled in language.
timezonestring
IANA time zone.
attributeslist
What Google lists about the place in its results (accessibility...). id is Google's own, the same in every language; value is true when the place has it.
highlightslist
Google's badges on the place: LGBTQ+ friendly, women-owned. id is the same in every language.
actionslist
What people can do from Google: reserve a table, order online. url is Google's own page for it; providers are the services it sends to (OpenTable, a delivery service, the place's site).
owner.idstring
owner.namestring
popular_times.weeklist
popular_times.live.hourinteger
popular_times.live.busynessinteger
popular_times.live.labelstring
admission.price.amountfloat
admission.price.currencystring
admission.price.textstring
admission.urlstring
admission.domainstring
admission.offerslist
hotel.check_instring
hotel.check_outstring
hotel.price.amountfloat
hotel.price.currencystring
hotel.price.textstring
hotel.similarlist
things_to_dolist
The tours and activities Google offers at the place: title, seller, price, duration, rating.
ids.place_idstring
ids.cidstring
Customer id: the second half of feature_id, in decimal; google.com/maps?cid= opens the place.
ids.feature_idstring
Feature id (0x...:0x...), what reviews and photos are listed by.
ids.kgmidstring
Knowledge Graph id (/g/...).
photo_urlstring
The place's main photo.
urlstring
The place on Google Maps (Maps URLs, query_place_id).
source_urlstring
The place's page these values were read from.
observed_atdate
When they were read
photoslist
The photos on the place's page, full size.
relatedlist
What Google shows as "People also search for", by group, each place by its feature id (read it with places/get).
insidelist
The places inside this one: a shop in a museum, a stand in a market.

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_place422This place id or link does not say which place it is on Google's side; send its cid or its page's link.
ambiguous_query422This name matches several places; choose one and send its id as place.
place_not_found404Google knows no such place (not charged).
site_unavailable503Google did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424Google answered in a shape we do not read yet; we are told and fix it, and it is not charged. Retrying now gives the same.

Price

1 credit a call. A place that is not found, an ambiguous name and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

2.0.12026-11-09
A well-formed place id that names no place answers place_not_found (404, not charged), as it should; it answered unexpected_answer.
2.0.02026-11-08
One input for the place: place takes a name with its city too ("Le Vieux Lyon, Lyon"), as it takes an id, a cid, a feature id or a link; query is gone (a call that still sends it answers invalid_options: send the name as place).
1.2.02026-10-27
primary_category_id said it was the main category's id but held Google's search-result type, a family for most places (shopping for a sewing machine store). That value is now result_type. primary_category_id is the main category's real id, which only a place's page gives: places/get fills it, places/search leaves it null.
1.1.02026-10-27
Three fields Google gives on a place's page: rating.distribution (reviews per number of stars), review_topics (the topics drawn from the reviews, with their mentions) and owner_description (what the place says of itself). Found by the preventive loop (lobstrio/platform#19).
1.0.02026-10-26
First version on the API v2.