Place Customer Reviews & Owner Replies

GET/v1/places/reviews2 Credits / review (min 10; 0 if empty)($0.0002 / review ($0.08–$0.20 / 1K reviews))

Fetch verified customer reviews for any Google Maps business by place_id or cid. Supports sorting by newest, highest_rating, lowest_rating, or most_relevant, plus keyword filtering.

Parameters

place_idstringrequired
Google Maps Place ID or numeric CID.
Example: ChIJN5X_gWdZwokRck9rk2guJ1M
sortstring
Sort order: 'most_relevant', 'newest', 'highest_rating', or 'lowest_rating'.
Example: newest
limitinteger (1 to 100)
Number of reviews to return (1 to 100, default 20).
Example: 20
querystring
Optional keyword filter to match inside review text (e.g., 'espresso', 'service').
Example: espresso

Example Request (cURL / Python / JavaScript)

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

Live Response Preview

{
  "request_id": "req_gm_66109d2fa118",
  "status": "ok",
  "data": [
    {
      "review_id": "ChdDSUhNMG9nS0VJQ0FnSUR4cE95djlBRRAB",
      "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
      "rating": 5,
      "review_text": "Hands down the most stunning coffee shop interior in Manhattan. The Hickory Smoked S'mores Latte and housemade almond milk espresso are incredible.",
      "published_at": "2026-10-28T14:22:10Z",
      "relative_time": "a week ago",
      "likes_count": 4,
      "author": {
        "name": "Elena Rostova",
        "profile_url": "https://www.google.com/maps/contrib/10829481928374",
        "avatar_url": "https://lh3.googleusercontent.com/a-/ALV-UjX8291",
        "is_local_guide": true,
        "total_reviews": 148
      },
      "owner_response": {
        "text": "Thank you so much for visiting us in SoHo, Elena! Thrilled you loved the Smoked S'mores Latte.",
        "published_at": "2026-10-29T09:15:00Z"
      },
      "images": [
        "https://lh5.googleusercontent.com/p/AF1QipN928172_felix_latte"
      ]
    }
  ],
  "meta": {
    "credits_used": 10,
    "credits_remaining": 1950,
    "count": 1,
    "has_more": true,
    "next_cursor": "CAESY0NBRVFDaHBFUTJwRlNVRlNTWEJEWjI5QlVEY3lTR2R4",
    "cache_hit": false
  }
}

Response Fields

List of verified customer reviews with author metadata and owner responses.

Field	Type	Sample / Notes
`request_id`	string	Unique request trace identifier.
`status`	string	Response status ('ok').
`data`	array of ReviewItem	Verified customer reviews.
`review_id`	string	Unique Google review identifier.
`place_id`	string	Associated Google Maps Place ID.
`rating`	integer	Star rating from 1 to 5.
`review_text`	string	Full customer review text.
`published_at`	string	ISO 8601 publication timestamp.
`relative_time`	string	Human-readable relative age (e.g., '2 weeks ago').
`likes_count`	integer	Number of helpful votes on the review.
`images`	array of string	Customer-uploaded review photo URLs.
`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: List of verified customer reviews with author metadata and owner responses.