Places (Search) API Developer's Guide

Review Media Type

The review media type represents a review of a place.

Media Type URI

Attribute Type Description
reviewId String An identifier for the review
date String (RFC 3339 date-time); optional The date the review was uploaded.
title String; optional The review's title
rating Number; optional A rating for the place, on a scale of 1 to 5.
description String (formatted text) The review itself.
user Object[User]; optional The user who made the review
language String (RFC 5646 language tag); optional The language of the review
via Object[Link]; optional  
supplier Object[Link]; optional  
attribution String (formatted text); optional  

GET Example

To retrieve a review, a client application can use the GET method. Here is an example for how to use GET with the review media type:

GET /places/v1/places/{placeId}/media/reviews/{reviewId}

See below for a sample of a JSON response for the GET method:

  "reviewId": "ugc-c425eb5b-3a69-4f45-8e2f-61ebd571fb1d",
  "date": "2013-05-08T03:13:12Z",
  "rating": 2,
  "description": "My review",
  "user": {
    "id": "05e...",
    "name": "Mustermann",
    "href": "https://...",
    "icon": "https://...",
    "type": "text/html"
  "language": "en",
  "supplier": {
    "id": "here",
    "title": "HERE",
    "href": "http://...",
    "type": "urn:nlp-types:supplier",
    "icon": "http://..."
  "via": {
    "href": "",
    "type": "text/html"
  "attribution": "Provided by <a href=\"\">Mustermann</a> via <a href=\"\">HERE</a>"