Booking Holdings · JSON Structure

Demand Api Accommodations Review Output Structure

AccommodationsReviewOutput schema from Booking.com Demand API

Type: object Properties: 9
AccommodationsAirlinesCar RentalsHospitalityHotelsRestaurantTravel

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"
    }
  }
}

Work with this as data

Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for json structure

4 MCP tools reach this
  • find_json_structuresBrowse and filter every JSON Structure in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/demand-api-accommodations-review-output-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.