Booking Holdings · Schema

AccommodationsReviewOutput

AccommodationsReviewOutput schema from Booking.com Demand API

AccommodationsAirlinesCar RentalsHospitalityHotelsRestaurantsTravel

Properties

Name Type Description
id integer Unique identifier of the review.
date string The date when the review was last modified. Format: YYYY-MM-DD.
language string An IETF language tag code that uniquely identifies a supported human language or dialect as described here: https://en.wikipedia.org/wiki/IETF_language_tag. Note that in v3 the whole tag is always low
negative stringnull Negative comments from this review.
positive stringnull Positive comments from this review.
reviewer object
score number The aggregated score of the review.
summary stringnull The summary of the review.
text_meets_guidelines boolean Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines.
View JSON Schema on GitHub

JSON Schema

demand-api-accommodations-review-output-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/booking-holdings/refs/heads/main/json-schema/demand-api-accommodations-review-output-schema.json",
  "title": "AccommodationsReviewOutput",
  "description": "AccommodationsReviewOutput schema from Booking.com Demand API",
  "type": "object",
  "properties": {
    "id": {
      "description": "Unique identifier of the review.",
      "type": "integer"
    },
    "date": {
      "description": "The date when the review was last modified. Format: YYYY-MM-DD.",
      "type": "string",
      "format": "date"
    },
    "language": {
      "description": "An IETF language tag code that uniquely identifies a supported human language or dialect as described here: https://en.wikipedia.org/wiki/IETF_language_tag. Note that in v3 the whole tag is always lowercase. Examples: \"nl\" for Dutch/Nederlands or \"en-us\" for English (US). To retrieve the full list of supported languages, call the `/common/languages` endpoint in the same Demand API version you are using.",
      "type": "string",
      "pattern": "^[a-z]{2}(-[a-z]{2})?$"
    },
    "negative": {
      "description": "Negative comments from this review.",
      "type": [
        "string",
        "null"
      ]
    },
    "positive": {
      "description": "Positive comments from this review.",
      "type": [
        "string",
        "null"
      ]
    },
    "reviewer": {
      "type": "object",
      "properties": {
        "country": {
          "description": "A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling <a href=\"/demand/docs/open-api/demand-api/commonlocations/common/locations/countries\" target=\"_blank\">common/locations/countries</a>.",
          "type": "string",
          "pattern": "^[a-z]{2}$"
        },
        "name": {
          "description": "Name of the reviewer. If the value is null then the reviewer is anonymous.",
          "type": [
            "string",
            "null"
          ]
        },
        "travel_purpose": {
          "description": "Defines if this was a leisure or business trip.",
          "type": "string",
          "enum": [
            "business",
            "leisure"
          ]
        },
        "type": {
          "description": "The reviewer type.",
          "type": "string",
          "enum": [
            "couple",
            "extended_group",
            "family_with_children",
            "solo_traveller"
          ]
        }
      }
    },
    "score": {
      "description": "The aggregated score of the review.",
      "type": "number",
      "minimum": 1,
      "maximum": 10
    },
    "summary": {
      "description": "The summary of the review.",
      "type": [
        "string",
        "null"
      ]
    },
    "text_meets_guidelines": {
      "description": "Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines.",
      "type": "boolean"
    }
  }
}