Google Maps Place Reviews (Newest First, English)

{
  "type": "object",
  "oneOf": [
    {
      "not": {
        "required": [
          "startUrls"
        ]
      },
      "required": [
        "placeIds"
      ]
    },
    {
      "not": {
        "required": [
          "placeIds"
        ]
      },
      "required": [
        "startUrls"
      ]
    }
  ],
  "required": [
    "maxReviews"
  ],
  "properties": {
    "language": {
      "enum": [
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "The language of the results; only \"en\" (English) is offered."
    },
    "placeIds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^ChIJ[A-Za-z0-9_-]+$"
      },
      "maxItems": 2,
      "minItems": 1,
      "description": "One or two Google place IDs (each starts with ChIJ)."
    },
    "startUrls": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "url"
        ],
        "properties": {
          "url": {
            "type": "string",
            "pattern": "^https://www\\.google\\.com/maps\\?cid=[0-9]+$"
          }
        },
        "additionalProperties": false
      },
      "maxItems": 1,
      "minItems": 1,
      "description": "Instead of place IDs: a list holding one object whose url is a Google Maps place link of the form https://www.google.com/maps?cid=<number>."
    },
    "maxReviews": {
      "type": "integer",
      "maximum": 250,
      "minimum": 1,
      "description": "The most reviews to return for each place, from 1 to 250."
    },
    "reviewsSort": {
      "enum": [
        "newest"
      ],
      "type": "string",
      "default": "newest",
      "description": "Review order; only \"newest\" (newest first) is offered."
    },
    "personalData": {
      "enum": [
        true
      ],
      "type": "boolean",
      "default": true,
      "description": "Fixed at true: reviewer display names and IDs are included."
    },
    "reviewsOrigin": {
      "enum": [
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Which reviews to include; only \"all\" is offered."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Map link to the place."
          },
          "city": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's city."
          },
          "name": {
            "type": "string",
            "description": "The reviewer's display name."
          },
          "text": {
            "type": [
              "string",
              "null"
            ],
            "description": "The review text; null for a rating left without text."
          },
          "stars": {
            "type": "integer",
            "description": "The star rating, from 1 to 5."
          },
          "state": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's state."
          },
          "title": {
            "type": "string",
            "description": "The reviewed place's name."
          },
          "address": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's street address; null when the listing hides it."
          },
          "placeId": {
            "type": "string",
            "description": "The reviewed place's Google place ID."
          },
          "reviewId": {
            "type": "string",
            "description": "The review's ID."
          },
          "reviewUrl": {
            "type": "string",
            "description": "Link to the review."
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "All categories of the place."
          },
          "postalCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's postal code."
          },
          "reviewerId": {
            "type": "string",
            "description": "The reviewer's ID."
          },
          "totalScore": {
            "type": "number",
            "description": "The place's average star rating."
          },
          "countryCode": {
            "type": [
              "string",
              "null"
            ],
            "description": "The place's country code."
          },
          "categoryName": {
            "type": "string",
            "description": "The place's main category."
          },
          "isLocalGuide": {
            "type": "boolean",
            "description": "Whether the reviewer carries the Local Guide label."
          },
          "reviewOrigin": {
            "type": "string",
            "description": "The site the review came from."
          },
          "reviewsCount": {
            "type": "integer",
            "description": "The place's total review count."
          },
          "reviewContext": {
            "type": "object",
            "description": "Structured details the reviewer added (such as a price assessment or the service used), as label-value pairs; empty when none."
          },
          "publishedAtDate": {
            "type": "string",
            "description": "When the review was published, as an ISO 8601 timestamp."
          },
          "originalLanguage": {
            "type": [
              "string",
              "null"
            ],
            "description": "The language the review was written in."
          },
          "responseFromOwnerDate": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the owner replied, as an ISO 8601 timestamp; null when not."
          },
          "responseFromOwnerText": {
            "type": [
              "string",
              "null"
            ],
            "description": "The owner's reply; null when there is none."
          }
        }
      },
      "description": "The place's reviews, newest first, up to maxReviews for each place; fewer when the place has fewer."
    }
  },
  "description": "The reviews, as a list."
}