Place Details & Full Business Profile

GET/v1/places/details20 Credits / business profile($0.002 / profile ($0.80–$2.00 / 1K profiles))

Retrieve the complete Google Business Profile by place_id, cid, or google_id. Includes verified contact info, rating breakdown (1-star to 5-star counts), full weekly opening hours, service attributes, and cached website contact enrichment.

Parameters

place_idstringrequired
Google Maps Place ID (e.g., 'ChIJN5X_gWdZwokRck9rk2guJ1M'), numeric CID, or hex Google ID.
Example: ChIJN5X_gWdZwokRck9rk2guJ1M
languagestring
ISO 639-1 language code (default 'en').
Example: en
freshboolean
Bypass local PostgreSQL cache and fetch live from Google Maps.
Example: false

Example Request (cURL / Python / JavaScript)

curl "https://api.googlemapsapi.io/v1/places/details?place_id=ChIJN5X_gWdZwokRck9rk2guJ1M" \
  -H "x-api-key: gm_live_your_api_key"

Live Response Preview

{
  "request_id": "req_gm_77123c8ea901",
  "status": "ok",
  "data": {
    "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
    "google_id": "0x89c2596781ff9537:0x53272e68936b4f72",
    "cid": "5991807586670235506",
    "name": "Felix Roasting Co.",
    "description": "Ornate, high-design cafe serving artisanal espresso drinks, housemade non-dairy milks & pastries.",
    "primary_category": "Coffee shop",
    "categories": [
      "Coffee shop",
      "Cafe",
      "Espresso bar",
      "Pastry shop"
    ],
    "rating": 4.5,
    "review_count": 782,
    "reviews_per_rating": {
      "1": 24,
      "2": 18,
      "3": 42,
      "4": 136,
      "5": 562
    },
    "price_level": "$$",
    "phone": "+1 212-359-1139",
    "phone_e164": "+12123591139",
    "website": "https://felixroastingco.com",
    "domain": "felixroastingco.com",
    "address": {
      "formatted": "450 Broome St, New York, NY 10013",
      "street": "450 Broome St",
      "city": "New York",
      "state": "New York",
      "postal_code": "10013",
      "country_code": "US",
      "plus_code": "87G7PXXW+8Q"
    },
    "coordinates": {
      "latitude": 40.722341,
      "longitude": -74.001298
    },
    "business_status": "OPERATIONAL",
    "is_claimed": true,
    "working_hours": {
      "monday": [
        "08:00–18:00"
      ],
      "tuesday": [
        "08:00–18:00"
      ],
      "wednesday": [
        "08:00–18:00"
      ],
      "thursday": [
        "08:00–18:00"
      ],
      "friday": [
        "08:00–18:00"
      ],
      "saturday": [
        "08:30–18:30"
      ],
      "sunday": [
        "08:30–18:30"
      ]
    },
    "attributes": {
      "Service options": [
        "Outdoor seating",
        "Takeout",
        "Dine-in"
      ],
      "Highlights": [
        "Great coffee",
        "Great tea selection"
      ],
      "Accessibility": [
        "Wheelchair accessible entrance"
      ]
    },
    "contacts_enrichment": {
      "emails": [
        "[email protected]",
        "[email protected]"
      ],
      "social_links": {
        "instagram": "https://www.instagram.com/felixroastingco",
        "facebook": "https://www.facebook.com/felixroastingco"
      }
    },
    "google_maps_url": "https://www.google.com/maps/place/?q=place_id:ChIJN5X_gWdZwokRck9rk2guJ1M"
  },
  "meta": {
    "credits_used": 20,
    "credits_remaining": 1960,
    "count": 1,
    "has_more": false,
    "next_cursor": null,
    "cache_hit": false
  }
}

Response Fields

Complete Google Business Profile object.

Field	Type	Sample / Notes
`request_id`	string	Unique request trace identifier.
`status`	string	Response status ('ok').
`data`	PlaceSummary	Full Google Business Profile with hours, attributes, and enriched contacts.
`place_id`	string	Unique Google Maps Place ID (ChIJ...).
`google_id`	string	Hexadecimal Google feature ID (0x...:0x...).
`cid`	string	Numeric Google Customer ID (CID).
`name`	string	Official business title on Google Maps.
`primary_category`	string	Primary business category.
`categories`	array of string	All assigned business categories.
`rating`	number	Aggregate star rating (1.0 to 5.0).
`review_count`	integer	Total number of Google Maps user reviews.
`price_level`	string	Price tier indicator ($ to $$$$).
`phone`	string	Formatted local phone number.
`phone_e164`	string	E.164 international phone number.
`website`	string	Official business website URL.
`domain`	string	Normalized root domain.
`address`	AddressObject
`formatted`	string	Full human-readable street address.
`street`	string	Street number and street name.
`city`	string	City or locality.
`state`	string	State, province, or region.
`postal_code`	string	ZIP or postal code.
`country_code`	string	ISO 3166-1 alpha-2 country code.
`plus_code`	string	Google Open Location Code (Plus Code).
`coordinates`	CoordinatesObject
`latitude`	number	WGS84 latitude coordinate.
`longitude`	number	WGS84 longitude coordinate.
`business_status`	string	OPERATIONAL, CLOSED_TEMPORARILY, or CLOSED_PERMANENTLY.
`is_claimed`	boolean	Whether the Google Business Profile is owner-verified.
`google_maps_url`	string	Direct link to the place on Google Maps.
`meta`	ResponseMeta
`credits_used`	integer	Credits deducted for this API call.
`credits_remaining`	integer	Remaining credit balance on the account.
`count`	integer	Number of records returned in data.
`has_more`	boolean	Whether additional pages are available.
`next_cursor`	string	Opaque cursor token for fetching the next page.
`cache_hit`	boolean	Whether the response was served from the sub-50ms local index.

Status Codes

200: Complete Google Business Profile object.