Place Details

Full Google Maps place details for any Place ID — ratings, reviews, hours, photos, contact info, amenities, coordinates, and timezone, sourced live from the Google Places API (New).

POST/v1/maps/place

$0.05/call

Look up a single place by its Google Place ID and get back the full business profile — sourced directly from the official Google Places API (New). Use the id returned by Maps Search, or any Place ID you already have. The place_id field accepts both the raw ID (ChIJ...) and the resource-name form (places/ChIJ...).

Usage

const res = await fetch('https://api.yepapi.com/v1/maps/place', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    place_id: 'ChIJBR3G8LJqkFQRWD2Wzn0qG3c',
    language: 'en',
    region: 'us',
  }),
});
const { data } = await res.json();
console.log(data);

curl -X POST https://api.yepapi.com/v1/maps/place \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"place_id": "ChIJBR3G8LJqkFQRWD2Wzn0qG3c", "language": "en", "region": "us"}'

Request Body

Parameter	Type	Required	Description	Default
`place_id`	`string`	Yes	Google Place ID. Accepts the raw ID (`ChIJBR3G8LJqkFQRWD2Wzn0qG3c`) or the resource name (`places/ChIJBR3G8LJqkFQRWD2Wzn0qG3c`).	—
`language`	`string`	No	BCP-47 language code (e.g. `en`, `es`, `fr`).	`"en"`
`region`	`string`	No	CLDR region code (e.g. `us`, `gb`, `de`).	—

Response

{
  "ok": true,
  "data": {
    "id": "ChIJBR3G8LJqkFQRWD2Wzn0qG3c",
    "name": "Storyville Coffee Company",
    "types": ["coffee_shop", "cafe", "store", "food", "point_of_interest", "establishment"],
    "primaryType": "coffee_shop",
    "address": "94 Pike St #34, Seattle, WA 98101, USA",
    "phone": "(206) 780-5777",
    "website": "https://www.storyville.com/",
    "googleMapsUrl": "https://maps.google.com/?cid=8006338809770720088",
    "latitude": 47.6089519,
    "longitude": -122.3405629,
    "rating": 4.6,
    "userRatingCount": 1842,
    "priceLevel": "moderate",
    "businessStatus": "OPERATIONAL",
    "openNow": true,
    "hours": [
      "Monday: 7:00 AM – 6:00 PM",
      "Tuesday: 7:00 AM – 6:00 PM",
      "Wednesday: 7:00 AM – 6:00 PM",
      "Thursday: 7:00 AM – 6:00 PM",
      "Friday: 7:00 AM – 6:00 PM",
      "Saturday: 7:00 AM – 6:00 PM",
      "Sunday: 7:00 AM – 6:00 PM"
    ],
    "timezone": "America/Los_Angeles",
    "amenities": {
      "dineIn": true,
      "takeout": true,
      "delivery": false,
      "servesCoffee": true,
      "servesBreakfast": true,
      "servesDessert": true,
      "goodForGroups": true,
      "outdoorSeating": false
    },
    "photos": [
      {
        "reference": "places/ChIJBR3G8LJqkFQRWD2Wzn0qG3c/photos/AU_ZVEFd3Y9YtVSYWUZf4lYRda5p51TB2iSOLW...",
        "width": 1200,
        "height": 800,
        "attribution": "Storyville Coffee Company",
        "googleMapsUrl": "https://www.google.com/maps/place//data=!3m4!1e2!3m2!..."
      }
    ],
    "topReview": {
      "rating": 5,
      "text": "Hands down the best latte and cinnamon roll in Pike Place. Cozy spot with a view over the market.",
      "author": "Marcus Bell",
      "publishedAt": "2026-05-18T16:04:11Z",
      "relativeTime": "2 months ago"
    },
    "directionsUrl": "https://www.google.com/maps/dir//...",
    "reviewsUrl": "https://www.google.com/maps/place//..."
  }
}

Response Fields

data is a single place object with the same fields as one item in the Maps Search results[] array, plus timezone.

Field	Type	Description
`data.id`	`string`	Stable Google Place ID.
`data.name`	`string`	Display name as shown on Google Maps.
`data.types`	`string[]`	All place categories Google associates with this place.
`data.primaryType`	`string`	Primary place type, e.g. `coffee_shop`, `restaurant`, `gym`.
`data.address`	`string`	Full formatted street address.
`data.phone`	`string?`	National format phone number.
`data.website`	`string?`	Business website URL.
`data.googleMapsUrl`	`string?`	Direct Google Maps URL for the place.
`data.latitude` / `longitude`	`number`	Geographic coordinates.
`data.rating`	`number?`	Average star rating (0.0–5.0).
`data.userRatingCount`	`number?`	Total number of user ratings.
`data.priceLevel`	`string?`	One of `free`, `inexpensive`, `moderate`, `expensive`, `very_expensive`.
`data.businessStatus`	`string?`	`OPERATIONAL`, `CLOSED_TEMPORARILY`, or `CLOSED_PERMANENTLY`.
`data.openNow`	`boolean?`	Whether the place is open right now.
`data.hours`	`string[]?`	Array of weekday-formatted opening hours strings.
`data.timezone`	`string?`	IANA timezone (e.g. `America/Los_Angeles`).
`data.amenities`	`object?`	Boolean flags: `dineIn`, `takeout`, `delivery`, `servesCoffee`, `servesBreakfast`, `outdoorSeating`, `goodForGroups`, etc.
`data.photos`	`object[]?`	Place photos with `reference`, `width`, `height`, `attribution`, `googleMapsUrl`.
`data.topReview`	`object?`	Most recent featured review: `rating`, `text`, `author`, `publishedAt`, `relativeTime`.
`data.directionsUrl` / `reviewsUrl`	`string?`	Deep links into Google Maps.

Pricing

$0.05 per call. No monthly minimums.

Under the Hood

This endpoint queries the Google Places API (New) directly (places.get). All fields are sourced from Google Maps in real time and normalized into the response shape above.