Google place ID
Which ID do you have?
What Google place ID means
A place ID is an identifier Google gives each business and location in Maps, such as ChIJszGcvzV0bIcR3_6j5Gru8sM. It is the key for asking about one place instead of searching by name, which may match several businesses.
Google Maps uses two more identifiers for the same place. The data ID, or feature ID, is two hex numbers joined by a colon, such as 0x876c7435bf9c31b3:0xc3f2ee6ae4a3fedf, and appears in Google Maps URLs after !1s. The CID, or customer ID, is a decimal number such as 14119609924629823199 and opens the place at maps.google.com/?cid=<cid>. The CID is the second half of the data ID written in decimal: 0xc3f2ee6ae4a3fedf is 14119609924629823199. A place ID cannot be converted to either one; it comes from Google, alongside them.
Place IDs are stable but not permanent: Google can change them when a business moves or listings are merged. Google's own guidance for its Places API is to refresh stored place IDs that are more than twelve months old.
Clair's Google Maps search returns place_id, data_id, and cid for each business, so you can store whichever your other tools expect. The Place endpoint takes place_id and returns that one business with its hours, rating histogram, and reviews.
How to find a Google place ID
Google Maps does not print the place ID on a listing, and a Google Maps link does not contain it: the long URL carries the data ID after !1s, and a cid link carries the CID. Neither converts to a place ID. These are the ways to get one:
- Google's Place ID Finder, on the place ID page of the Google Maps Platform documentation: search for a place on its map and it shows the ID. Fine for a handful of places.
- The Places API: a Text Search request returns the ID of each matching place, as id in Places API (New) and place_id in the legacy API. It needs a Google Cloud project with billing enabled.
- Clair's Google Maps search: every business in the results carries place_id, together with data_id and cid, so one search such as "plumbers in Denver" returns the IDs of every listed business at once.
Open a place from its place ID
Google's Maps URLs format opens a place by its ID. Put the ID in query_place_id and a name or address in query, which Maps uses only if it cannot find the ID: https://www.google.com/maps/search/?api=1&query=Starbucks&query_place_id=ChIJsU30zM1qkFQRbnOm1_LBoG0 is Google's own example.
A data ID or CID opens at maps.google.com/?cid= followed by the CID. Typing place_id:ChIJ… or place_id:0x… into a search box is not a documented Google feature; the two URLs are.
Place ID vs CID vs data ID
| Identifier | Looks like | Where you see it | Relation |
|---|---|---|---|
| Place ID | ChIJszGcvzV0bIcR3_6j5Gru8sM | Places API, Place ID Finder, Clair's place_id | Issued by Google; converts to neither |
| Data ID (feature ID) | 0x876c7435bf9c31b3:0xc3f2ee6ae4a3fedf | Google Maps URLs, after !1s | Its second half is the CID in hex |
| CID | 14119609924629823199 | maps.google.com/?cid=… | The data ID's second half in decimal |
How it appears in a response
GET /v1/google-maps/search?q=plumbers+in+Denver&country=us · results.0
{
"position": 1,
"title": "Applewood Plumbing Heating & Electric",
"place_id": "ChIJkWUJx22Ha4cRVVLq4AJk7Ng",
"data_id": "0x876b876dc7096591:0xd8ec6402e0ea5255",
"cid": "15630978370222314069",
"latitude": 39.7583004,
"longitude": -105.0512657,
"rating": 4.8,
"reviews_count": 17793,
"category": "Plumber",
"price": null,
"address": "5000 W 29th Ave",
"open_state": "Open · Closes 10 PM",
"phone": "(303) 444-1633",
"website": "https://www.applewoodfixit.com/",
"description": null,
"wheelchair_accessible": null,
"action_links": [
{
"label": "Book online",
"url": "https://book.servicetitan.com/lhxa271djh03w5bfje81s0qd"
}
],
"thumbnail": null,
"sponsored": false,
"url": "https://www.google.com/maps/place/?q=place_id:ChIJkWUJx22Ha4cRVVLq4AJk7Ng"
}Common questions
What is place_id:0x…:0x…?
A data ID, not a place ID, despite the label: two hex numbers joined by a colon, such as 0x876c7435bf9c31b3:0xc3f2ee6ae4a3fedf. Several scraping tools and Maps exports print it as place_id. The Places API does not accept it, but its second half, written in decimal, is the place's CID, which opens the place at maps.google.com/?cid=.
Do Google place IDs change?
They can. Google says a place ID may change when its Maps database is updated, for example when a business moves or closes, and an outdated ID returns NOT_FOUND. Google recommends refreshing stored IDs that are more than 12 months old.
Is it free to get a place ID?
The Place ID Finder in Google's documentation is free for looking places up by hand, and Google lets you refresh stored place IDs at no charge when a request asks only for the ID. Other Places API fields are billed.
How long is a place ID?
There is no fixed length. Business IDs are often 27 characters starting with ChIJ, but IDs for street addresses, routes, and intersections can be much longer. Store the whole value: a truncated ID fails.

Glassdoor API
Crunchbase API
Instagram API
Bloomberg API
Associated Press API