Google Map API endpoint
Returns the Google Maps details of one place by its Google `place_id`: name, categories, address, coordinates, phone, website, description, image, amenities, rating and review count. `rating` is `null` when the place has no aggregate rating on Google.
/google/map/place/{place_id}Path parameters:
place_id: required. Google Place ID.Response behavior:
rating is the aggregate Google rating (1.0–5.0), or null when the place has no aggregate rating on Google (too few reviews, or a place type Google does not rate) — never a literal 0. Read it together with review_count.| Field | In the sample | Value in the sample |
|---|---|---|
| url | Has a value | google.com |
| name | Has a value | “Googleplex” |
| place_id | Has a value | |
| category | Has a value | 2 entries |
| address | Has a value | |
| latitude | Has a value | |
| longitude | Has a value | |
| rating | Has a value | 4.1 |
| review_count | Has a value | 9,646 |
| website | Has a value | about.google |
| phone | Has a value | 16,502,530,000 |
| description | Has a value | “The global headquarters of Google, this campus encompasses…” |
| image | Has a value | lh3.googleusercontent.com |
| locations | Has a value | 12 entries |
| amenities | Empty |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| place_id (path) | string | Yes | Google Place ID | ChIJs3cv0KuvEmsRHcXYwNJ6GU0 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/google/map/place/ChIJs3cv0KuvEmsRHcXYwNJ6GU0" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"url": "https://www.google.com/maps/place/?q=place_id:ChIJs3cv0KuvEmsRHcXYwNJ6GU0",
"name": "Primi Italian",
"place_id": "ChIJs3cv0KuvEmsRHcXYwNJ6GU0",
"category": [
"italian_restaurant"
],
"address": "168 Clarence St,Sydney NSW 2000,Australia",
"latitude": -33.8701437,
"rating": 4.1,
"review_count": 3213
}
}Request schema
No body schema
Response schema
#/definitions/google.mapPlaceResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | google.Place | No | ||||
| data.address | string | No | 250 Beach St, San Francisco, CA 94133 | Full street address of the place as shown on Google Maps. | ||
| data.amenities | array | No | ['Free Wi-Fi', 'Air-conditioned', 'Wi-Fi', 'Parking'] | Amenities Google Maps lists for the place, for example `Free Wi-Fi`. | ||
| data.category | array | No | ['hotel'] | Business categories Google Maps assigns to the place. | ||
| data.description | string | No | A 3-minute walk from Pier 41 in the Fisherman's Wharf district... | Description of the place from its Google Maps listing. | ||
| data.image | string | No | https://lh5.googleusercontent.com/p/AF1QipP_O55x7gOwR3AaM09CVmzEUude9wMHMPwc--yp | URL of the main photo of the place. | ||
| data.latitude | number | No | 37.8077617 | Latitude of the place in decimal degrees. | ||
| data.locations | array | No | ['San Francisco', 'Los Angeles'] | Location names Google Maps associates with the place, such as nearby areas. | ||
| data.longitude | number | No | -122.4132228 | Longitude of the place in decimal degrees. | ||
| data.name | string | No | Hotel Zephyr San Francisco | Name of the place as shown on Google Maps. | ||
| data.phone | string | No | 14156176565 | Phone number of the place, as digits. | ||
| data.place_id | string | No | ChIJ99URUeOAhYAR0J5ZUxTesDQ | Google Place ID. Use it with the place, reviews and photos endpoints. | ||
| data.rating | number | No | 4.1 | Rating is the aggregate Google rating (1.0–5.0), or null when the place has no aggregate rating on Google (Google never assigns a 0.x average, so 0 always meant "unrated"). A pointer so unrated serializes as `rating: null`, not a misleading 0. | ||
| data.review_count | integer | No | 3213 | Number of Google reviews for the place. | ||
| data.url | string | No | https://www.google.com/maps/place/?q=place_id:ChIJ99URUeOAhYAR0J5ZUxTesDQ | Google Maps URL of the place. | ||
| data.website | string | No | https://www.hotelzephyrsf.com/ | Website of the place. | ||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/google/map/place/ChIJs3cv0KuvEmsRHcXYwNJ6GU0" \
-H "x-api-key: $CRAWLORA_API_KEY"