Google Hotel Info Live Advanced

{
  "$defs": {
    "BusinessDataGoogleHotelInfoLiveAdvancedRequestInfo": {
      "properties": {
        "adults": {
          "anyOf": [
            {
              "description": "number of adultsoptional fieldif you don't specify this field, two adults will be used by defaultexample:1",
              "type": "integer"
            },
            {
              "type": "null"
            }
          ]
        },
        "check_in": {
          "anyOf": [
            {
              "description": "check-in dateoptional fieldif you don't specify this field, tomorrow's date will be used by default;the value must not be earlier than today's datedate format: \"yyyy-mm-dd\"example:\"2019-01-15\"",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "check_out": {
          "anyOf": [
            {
              "description": "check-out dateoptional fieldif you don't specify this field, our system will apply the date of two days from now by default;Note: the value cannot be less than or equal to check_in;the range between check_in and check_out values cannot exceed 30 daysdate format: \"yyyy-mm-dd\"example:\"2019-01-15\"",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "children": {
          "anyOf": [
            {
              "description": "number and age of childrenoptional fieldif you don't specify this field, no children will be included in the search;set the following value if you want to include one 14-years-old child:[14]set the following value if you want to include one 13-years-old child and one 8-years-old child:[13,8]",
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ]
        },
        "currency": {
          "anyOf": [
            {
              "description": "currencyoptional fieldexample:\"USD\"",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "hotel_identifier": {
          "description": "unique hotel identifierrequired fieldunique identifier of a hotel entity in Google search;you can obtain the value by making a request to Advanced Google SERP API (enclosed in the hotels element of the response), or the Hotel Searches endpoint of Business Data APIexample:ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE",
          "type": "string"
        },
        "language_code": {
          "description": "search engine language coderequired field if you don't specify language_nameif you use this field, you don't need to specify language_nameyou can receive the list of available languages with their language_code_by making a separate request to",
          "type": "string"
        },
        "language_name": {
          "description": "full name of search engine languagerequired field if you don't specify language_codeif you use this field, you don't need to specify language_codeyou can receive the list of available languages with language_name by making a separate request to",
          "type": "string"
        },
        "load_prices_by_dates": {
          "anyOf": [
            {
              "description": "load hotel stay prices by datesoptional fieldif you specify this parameter with true, the response will include the prices_by_dates array with hotel stay prices divided by datesif you use this parameter, you will be charged double the base price for a request",
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ]
        },
        "location_code": {
          "description": "search engine location coderequired field if you don't specify location_name_or location_coordinateif you use this field, you don't need to specify location_name or location_coordinateyou can receive the list of available locations with location_code by making a separate request to the",
          "type": "integer"
        },
        "location_coordinate": {
          "description": "GPS coordinates of a locationrequired field if you don't specify location_name_or location_codeif you use this field, you don't need to specify location_name or location_codelocation_coordinate parameter should be specified in the \"latitude, longitude\" formatthe maximum number of decimal digits for \"latitude\" and \"longitude\": 7Note: if the coordinates are used to set a location, the search will occur in the nearest settlement;example:53.476225,-2.243572n",
          "type": "string"
        },
        "location_name": {
          "description": "full name of search engine locationrequired field if you don't specify location_code or location_coordinateif you use this field, you don't need to specify location_code or location_coordinateyou can receive the list of available locations with location_name by making a separate request to Kingdom",
          "type": "string"
        },
        "prices_date_range": {
          "anyOf": [
            {
              "description": "predefined period for retrieving daily price dataoptional fieldto use this parameter, you must specify load_prices_by_dates with trueif the prices_start_date is not specified, the start date is set to check_in datepossible values: month, three_months, six_months, yeardefault value: month",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "prices_end_date": {
          "anyOf": [
            {
              "description": "end date to load prices by datesoptional fieldto use this parameter, you must specify load_prices_by_dates with trueif this parameter is not specified, you will get prices by date for the month date format: yyyy-mm-ddexample:2025-05-21",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "prices_start_date": {
          "anyOf": [
            {
              "description": "start date to load prices by datesoptional fieldto use this parameter, you must specify load_prices_by_dates with trueif this parameter is not specified, the start date is set to check_in datedate format: yyyy-mm-ddexample:2025-05-20",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        },
        "tag": {
          "anyOf": [
            {
              "description": "user-defined task identifieroptional fieldthe character limit is 255you can use this parameter to identify the task and match it with the resultyou will find the specified tag value in the data object of the response",
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "body": {
      "items": {
        "anyOf": [
          {
            "oneOf": [
              {
                "$ref": "#/$defs/BusinessDataGoogleHotelInfoLiveAdvancedRequestInfo"
              }
            ],
            "type": "object"
          },
          {
            "type": "null"
          }
        ]
      },
      "type": "array"
    }
  },
  "required": [],
  "type": "object"
}