Tripadvisor Place Reviews (Newest 10 or 20)

{
  "type": "object",
  "required": [
    "place_id",
    "sort_by"
  ],
  "properties": {
    "num": {
      "enum": [
        10,
        20
      ],
      "type": "integer",
      "default": 10,
      "description": "Number of reviews to return: 10 (the default) or 20."
    },
    "start": {
      "enum": [
        0
      ],
      "type": "integer",
      "default": 0,
      "description": "Review offset. Only 0, the newest reviews, is offered."
    },
    "sort_by": {
      "enum": [
        "recent"
      ],
      "type": "string",
      "description": "Review order. Only 'recent' (newest first) is offered."
    },
    "place_id": {
      "type": "string",
      "pattern": "^[1-9]\\d*$",
      "description": "The place's numeric Tripadvisor ID, as a string of digits. It is the number after '-d' in the place's Tripadvisor page address, and a Tripadvisor place search returns it."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The review's Tripadvisor ID."
          },
          "text": {
            "type": "string",
            "description": "The full review text, in the language it was written in."
          },
          "user": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The reviewer's display name."
              }
            }
          },
          "title": {
            "type": "string",
            "description": "The review's title."
          },
          "rating": {
            "type": "number",
            "description": "The reviewer's star rating."
          },
          "language": {
            "type": "string",
            "description": "Language code of the review, such as 'en' or 'fr'."
          },
          "max_rating": {
            "type": "number",
            "description": "The top of the rating scale."
          },
          "helpful_votes": {
            "type": "number",
            "description": "How many readers marked the review helpful."
          },
          "published_date": {
            "type": "string",
            "description": "Publication date, YYYY-MM-DD."
          }
        }
      },
      "description": "Up to 10 or 20 reviews (the `num` asked for), newest first."
    },
    "search_information": {
      "type": "object",
      "properties": {
        "total_results": {
          "type": "number",
          "description": "The place's total number of reviews on Tripadvisor."
        }
      }
    }
  },
  "description": "The place's newest reviews, as returned after shaping."
}