Booking Holdings · JSON Structure

Demand Api Accommodations Review Output Structure

AccommodationsReviewOutput schema from Booking.com Demand API

Type: object Properties: 9
AccommodationsAirlinesCar RentalsHospitalityHotelsRestaurantsTravel

AccommodationsReviewOutput is a JSON Structure definition published by Booking Holdings, describing 9 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

id date language negative positive reviewer score summary text_meets_guidelines

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/booking-holdings/refs/heads/main/json-structure/demand-api-accommodations-review-output-structure.json",
  "name": "AccommodationsReviewOutput",
  "description": "AccommodationsReviewOutput schema from Booking.com Demand API",
  "type": "object",
  "properties": {
    "id": {
      "description": "Unique identifier of the review.",
      "type": "int32"
    },
    "date": {
      "description": "The date when the review was last modified. Format: YYYY-MM-DD.",
      "type": "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": "double",
      "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"
    }
  }
}