Skip to content

Endpoints · 06/13

Reviews

Recent reviews for a place, looked up by cid, fid or placeId.

EndpointPOSThttps://serp-api.ozymoz.com/reviews
Credits per call1

Parameters

NameDescription
cidone of cid / fid / placeIdGoogle's place id (the cid of a places or maps result).
fidone of cid / fid / placeIdGoogle's feature id (0x…:0x…) — an alternative to cid.
placeIdone of cid / fid / placeIdGoogle Places API id — an alternative to cid.
glCountry to search from, as a two-letter code (us, tr, de…).Default: us
hlInterface language, as a language code (en, tr, de…).Default: en

Example request

curl -X POST 'https://serp-api.ozymoz.com/reviews' \
  -H 'X-API-KEY: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "cid": "2431845123845123845",
    "gl": "us",
    "hl": "en"
  }'

Example response

Illustrative values in the real shape. Top-level keys: reviews, nextPageToken.

response.json
{
  "searchParameters": {
    "type": "reviews",
    "engine": "google",
    "cid": "2431845123845123845",
    "gl": "us",
    "hl": "en"
  },
  "reviews": [
    {
      "rating": 5,
      "date": "a month ago",
      "snippet": "Best flat white in the neighbourhood, and the staff know their beans.",
      "likes": 3,
      "user": {
        "name": "A. Yılmaz",
        "reviews": 41,
        "photos": 12
      },
      "media": [],
      "id": "ChZDSUhNMG9nS0VJQ0FnSUR…"
    }
  ],
  "credits": 1
}

Good to know

Returns at most the first ~5 reviews per place — Google's signed-out view. Look a place up with its cid (from places or maps), fid or placeId.

Errors · Batch requests · Rate limits