Place Details
Get full details for a single Google Maps place by place_id. Returns everything Places Search returns, plus Plus Codes, a menu link, and an emails_and_contacts scrape of the place’s official website (emails, phone numbers and links to 10 social platforms).
Endpoint
GET /v1/places/details
Price: $0.003 per request Free tier: 50 requests/month
Parameters
| Parameter | Required | Description |
|---|---|---|
place_id |
Yes | Google place_id (e.g. ChIJifIePKtZwokRVZ-UdRGkZzs), as returned by the Places Search endpoint |
country |
No | 2-letter ISO 3166-1 alpha-2 region code (default: us) |
language |
No | 2-letter ISO 639-1 language code (default: en) |
Response Fields
The place object has the same schema as items in Places Search, plus the fields below.
| Field | Type | Description |
|---|---|---|
place |
object | Full place object (see Places Search for the shared schema) |
place.global_plus_code |
string | null | Global Plus Code (e.g. 87G8Q237+V5) |
place.compound_plus_code |
string | null | Compound Plus Code (e.g. Q237+V5 New York) |
place.menu_link |
string | null | Menu URL if the place has one |
place.emails_and_contacts |
object | Scrape of the place’s official website |
place.emails_and_contacts.emails |
array | Email addresses found on the site |
place.emails_and_contacts.phone_numbers |
array | Phone numbers found on the site (raw, not normalized to E.164) |
place.emails_and_contacts.facebook |
string | null | Facebook profile URL |
place.emails_and_contacts.instagram |
string | null | Instagram profile URL |
place.emails_and_contacts.linkedin |
string | null | LinkedIn profile URL |
place.emails_and_contacts.twitter |
string | null | Twitter/X profile URL |
place.emails_and_contacts.tiktok |
string | null | TikTok profile URL |
place.emails_and_contacts.youtube |
string | null | YouTube channel URL |
place.emails_and_contacts.pinterest |
string | null | Pinterest profile URL |
place.emails_and_contacts.snapchat |
string | null | Snapchat profile URL |
place.emails_and_contacts.yelp |
string | null | Yelp listing URL |
place.emails_and_contacts.github |
string | null | GitHub profile URL |
Example Request
cURL
curl "https://apidirect.io/v1/places/details?place_id=ChIJifIePKtZwokRVZ-UdRGkZzs" \
-H "X-API-Key: YOUR_API_KEY"
Python
import requests
response = requests.get(
"https://apidirect.io/v1/places/details",
headers={"X-API-Key": "YOUR_API_KEY"},
params={"place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs"}
)
print(response.json())
Example Response
{
"place": {
"place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs",
"name": "Joe's Pizza Broadway",
"type": "Pizza restaurant",
"subtypes": ["Pizza restaurant", "Pizza delivery", "Restaurant"],
"phone_number": "+16465594878",
"website": "https://www.joespizzanyc.com",
"domain": "joespizzanyc.com",
"rating": 4.5,
"review_count": 25433,
"reviews_per_rating": {"1": 753, "2": 604, "3": 2107, "4": 4946, "5": 17023},
"price_level": "$10–20",
"verified": true,
"business_status": "OPEN",
"opening_status": "Open · Closes 3 AM",
"working_hours": {"Monday": ["10 AM–3 AM"]},
"opening_date": null,
"address": "1435 Broadway, New York, NY 10018",
"street_address": "1435 Broadway",
"district": "Manhattan",
"city": "New York",
"state": "New York",
"zipcode": "10018",
"country": "US",
"latitude": 40.75468,
"longitude": -73.98703,
"timezone": "America/New_York",
"summary": "Modern outpost of a longtime counter-serve pizza joint prepping New York-style slices and pies.",
"about": {
"summary": "Modern outpost of a longtime counter-serve pizza joint prepping New York-style slices and pies.",
"details": {
"Accessibility": {
"Wheelchair accessible entrance": true,
"Wheelchair accessible parking lot": false,
"Wheelchair accessible seating": false
}
}
},
"photo_count": 22117,
"photos_sample": [
{
"photo_id": "CIABIhAViB6GuQB0Czq6u1UIyD60",
"type": "photo",
"photo_url": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAH...",
"photo_url_large": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAH...=w4280-h3407-k-no",
"video_thumbnail_url": null,
"latitude": 40.7546469,
"longitude": -73.9868158,
"photo_datetime_utc": "2026-05-30T00:00:00.000Z",
"photo_timestamp": 1780099200
}
],
"place_link": "https://www.google.com/maps/place/...",
"reviews_link": "https://search.google.com/local/reviews?placeid=ChIJifIePKtZwokRVZ-UdRGkZzs",
"booking_link": "https://www.google.com/searchviewer/42?...",
"reservations_link": "https://www.fooddiscoveryapp.com/new-york-city/joes-pizza",
"order_link": "https://www.google.com/searchviewer/42?...",
"owner_name": "Joe's Pizza Broadway",
"owner_link": "https://maps.google.com/maps/contrib/103877821925204408966",
"cid": "4280570365733019477",
"global_plus_code": "87G8Q237+V5",
"compound_plus_code": "Q237+V5 New York",
"menu_link": null,
"emails_and_contacts": {
"emails": [],
"phone_numbers": ["2123661182", "7183882216", "2122670860", "2123889474"],
"facebook": null,
"instagram": "https://www.instagram.com/joespizzanyc",
"linkedin": null,
"twitter": null,
"tiktok": null,
"youtube": null,
"pinterest": null,
"snapchat": null,
"yelp": null,
"github": null
}
}
}
Notes
- The website scrape runs on every call and adds ~0.5–1s to the response time.
- If the site is unreachable or has no contact info,
emails_and_contactsis returned with empty arrays andnullsocial links. - A 404 with
code: "not_found"is returned when theplace_iddoesn’t match any place;not_foundresponses are not charged.