Noclegowo

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['offer_ids', 'date_from', 'date_to'], 'properties': {'adults': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of adults (default 2).'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure (check-out) date, YYYY-MM-DD.'}, 'children': {'type': 'integer', 'maximum': 20, 'minimum': 0, 'description': 'Number of children (default 0, or the length of children_ages).'}, 'language': {'enum': ['pl', 'en'], 'type': 'string', 'description': "Language of the user's conversation ('pl' or 'en'). Determines the language of texts and the offer link locale."}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival (check-in) date, YYYY-MM-DD.'}, 'offer_ids': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 10, 'minItems': 1, 'description': 'offer_id values, as returned in search results.'}, 'children_ages': {'type': 'array', 'items': {'type': 'integer', 'maximum': 17, 'minimum': 0}, 'maxItems': 20, 'description': 'Children ages at check-in; they decide occupancy and price. Unknown ages are priced as school-age.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'language', 'stay', 'offers', 'missing_offer_ids'], 'properties': {'stay': {'type': 'object', 'required': ['date_from', 'date_to', 'nights', 'adults', 'children', 'children_ages'], 'properties': {'adults': {'type': 'number'}, 'nights': {'type': 'number'}, 'date_to': {'type': 'string'}, 'children': {'type': 'number'}, 'date_from': {'type': 'string'}, 'children_ages': {'type': 'array', 'items': {'type': 'number'}}}, 'additionalProperties': False}, 'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['offer_id', 'name', 'city', 'image_url', 'rating', 'reviews_count', 'price_from_pln', 'availability', 'total_price_pln', 'stay_price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Offer page on noclegowo.pl (the URL carries attribution parameters).'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'nearby': {'type': 'object', 'required': ['from', 'distance_km'], 'properties': {'from': {'type': 'string', 'description': 'The requested location this offer is near.'}, 'distance_km': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Distance from the centre of the requested location, km.'}}, 'description': 'Present on an alternative from a neighbouring locality, included because few offers were available in the requested place for these dates; the offer is not in the requested place.', 'additionalProperties': False}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'offer_id': {'type': 'number'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'why_match': {'type': 'string'}, 'stay_price': {'anyOf': [{'type': 'object', 'required': ['total', 'currency', 'nights', 'per_night', 'adults', 'children', 'date_from', 'date_to'], 'properties': {'total': {'type': 'number', 'description': 'Total for the whole stay and the whole party, PLN.'}, 'adults': {'type': 'number'}, 'nights': {'type': 'number'}, 'date_to': {'type': 'string'}, 'children': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'PLN'}, 'date_from': {'type': 'string'}, 'per_night': {'type': 'number', 'description': 'total / nights, rounded — whole party.'}, 'indicative': {'type': 'boolean', 'description': "True when the total is plausible but not backed by the host's calendar, so it is an indicative price to be confirmed with the host."}}, 'description': 'Date-specific quote from the availability check, for the requested dates and party.', 'additionalProperties': False}, {'type': 'null'}]}, 'availability': {'enum': ['available', 'unavailable', 'unknown', 'not_checked'], 'type': 'string', 'description': 'available / unavailable for the requested dates; unknown = host confirms on inquiry; not_checked = no dates given or not verified.'}, 'reviews_count': {'type': 'number'}, 'price_from_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Indicative "from" nightly rate from the listing price list; per person or per property depending on the listing. Not the price for specific dates.'}, 'total_price_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Same as stay_price.total; null without a quote.'}, 'stay_price_withheld': {'type': 'string', 'description': 'Set when the offer is available but the booking system quoted a total that failed plausibility checks; total_price_pln and stay_price are then null and the price for the dates is to be confirmed with the host.'}}, 'additionalProperties': False}, 'description': 'Available offers first, then unknown, then unavailable.'}, 'status': {'enum': ['ok', 'not_found', 'check_failed'], 'type': 'string'}, 'language': {'enum': ['pl', 'en'], 'type': 'string'}, 'missing_offer_ids': {'type': 'array', 'items': {'type': 'number'}}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['offer_id'], 'properties': {'adults': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of adults for the price (default 2). Only used with dates.'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure date, YYYY-MM-DD (see date_from).'}, 'children': {'type': 'integer', 'maximum': 20, 'minimum': 0, 'description': 'Number of children. Only used with dates.'}, 'language': {'enum': ['pl', 'en'], 'type': 'string', 'description': "Language of the user's conversation ('pl' or 'en'). Determines the language of texts and the offer link locale."}, 'offer_id': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'ID of the offer, as returned in search results (offer_id).', 'exclusiveMinimum': 0}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival date, YYYY-MM-DD. With date_from and date_to together (both or neither) the offer also carries availability and the whole-stay price.'}, 'children_ages': {'type': 'array', 'items': {'type': 'integer', 'maximum': 17, 'minimum': 0}, 'maxItems': 20, 'description': 'Children ages at check-in; they decide occupancy and price. Only used with dates.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'language', 'offer'], 'properties': {'offer': {'anyOf': [{'type': 'object', 'required': ['offer_id', 'name', 'city', 'accommodation_type', 'description', 'rating', 'reviews_count', 'price_from_pln', 'price_to_pln', 'location', 'image_url', 'photos', 'amenities', 'capacity', 'url'], 'properties': {'url': {'type': 'string'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'photos': {'type': 'array', 'items': {'type': 'string'}}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'capacity': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'number'}}, 'additionalProperties': False}}, 'location': {'type': 'object', 'required': ['city', 'lat', 'lng'], 'properties': {'lat': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'lng': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'city': {'type': 'string'}}, 'additionalProperties': False}, 'offer_id': {'type': 'number'}, 'amenities': {'type': 'array', 'items': {'type': 'string'}}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'stay_price': {'anyOf': [{'type': 'object', 'required': ['total', 'currency', 'nights', 'per_night', 'adults', 'children', 'date_from', 'date_to'], 'properties': {'total': {'type': 'number', 'description': 'Total for the whole stay and the whole party, PLN.'}, 'adults': {'type': 'number'}, 'nights': {'type': 'number'}, 'date_to': {'type': 'string'}, 'children': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'PLN'}, 'date_from': {'type': 'string'}, 'per_night': {'type': 'number', 'description': 'total / nights, rounded — whole party.'}, 'indicative': {'type': 'boolean', 'description': "True when the total is plausible but not backed by the host's calendar, so it is an indicative price to be confirmed with the host."}}, 'description': 'Date-specific quote from the availability check, for the requested dates and party.', 'additionalProperties': False}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'availability': {'enum': ['available', 'unavailable', 'unknown', 'not_checked'], 'type': 'string', 'description': 'Only when dates were passed: available / unavailable / unknown for them; not_checked when the check failed.'}, 'price_to_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'reviews_count': {'type': 'number'}, 'price_from_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_price_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Same as stay_price.total; only with dates.'}, 'accommodation_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'stay_price_withheld': {'type': 'string', 'description': 'See the search result: the price for the dates is to be confirmed with the host.'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'status': {'enum': ['ok', 'not_found'], 'type': 'string'}, 'language': {'enum': ['pl', 'en'], 'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['location'], 'properties': {'pets': {'type': 'boolean', 'description': 'True when the guests travel with a pet (dog, cat, …).'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many offers to return (default 6, max 10).'}, 'adults': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of adults.'}, 'date_to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure (check-out) date, YYYY-MM-DD.'}, 'children': {'type': 'integer', 'maximum': 20, 'minimum': 0, 'description': 'Number of children.'}, 'language': {'enum': ['pl', 'en'], 'type': 'string', 'description': "Language of the user's conversation ('pl' or 'en'). Determines the language of texts and the offer link locale."}, 'location': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Where to stay: city, region, mountain range, lake, landmark or area in Poland, e.g. "Zakopane", "Mazury", "nad morzem", "near Morskie Oko".'}, 'amenities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'maxItems': 20, 'description': 'Amenities the user wishes for, in their words, e.g. ["śniadanie", "sauna", "parking"]. A preference rather than a filter: offers that have them are ranked first and the others follow with a note.'}, 'date_from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival (check-in) date, YYYY-MM-DD.'}, 'budget_max': {'type': 'number', 'maximum': 1000000, 'description': 'Maximum budget in PLN.', 'exclusiveMinimum': 0}, 'budget_min': {'type': 'number', 'maximum': 1000000, 'description': 'Minimum budget in PLN.', 'exclusiveMinimum': 0}, 'budget_scope': {'enum': ['per_night', 'total_stay'], 'type': 'string', 'description': 'Whether the budget is per night (default) or for the whole stay.'}, 'expectations': {'type': 'string', 'maxLength': 1000, 'description': 'Other wishes in free text: type of place, style, atmosphere, distance to the beach or slopes, quiet area, etc. Personal data is not needed.'}, 'children_ages': {'type': 'array', 'items': {'type': 'integer', 'maximum': 17, 'minimum': 0}, 'maxItems': 20, 'description': 'Ages of the children, when known.'}, 'exclude_offer_ids': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 50, 'description': 'Offer ids to leave out of the results (for example offers already seen), so that further results are new ones.'}, 'required_amenities': {'type': 'array', 'items': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'maxItems': 20, 'description': 'Amenities that are hard requirements ("musi być", "koniecznie", "tylko z", "required"): offers without them are dropped.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'language', 'offers', 'questions'], 'properties': {'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['offer_id', 'name', 'city', 'image_url', 'rating', 'reviews_count', 'price_from_pln', 'availability', 'total_price_pln', 'stay_price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Offer page on noclegowo.pl (the URL carries attribution parameters).'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'nearby': {'type': 'object', 'required': ['from', 'distance_km'], 'properties': {'from': {'type': 'string', 'description': 'The requested location this offer is near.'}, 'distance_km': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Distance from the centre of the requested location, km.'}}, 'description': 'Present on an alternative from a neighbouring locality, included because few offers were available in the requested place for these dates; the offer is not in the requested place.', 'additionalProperties': False}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'offer_id': {'type': 'number'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'why_match': {'type': 'string'}, 'stay_price': {'anyOf': [{'type': 'object', 'required': ['total', 'currency', 'nights', 'per_night', 'adults', 'children', 'date_from', 'date_to'], 'properties': {'total': {'type': 'number', 'description': 'Total for the whole stay and the whole party, PLN.'}, 'adults': {'type': 'number'}, 'nights': {'type': 'number'}, 'date_to': {'type': 'string'}, 'children': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'PLN'}, 'date_from': {'type': 'string'}, 'per_night': {'type': 'number', 'description': 'total / nights, rounded — whole party.'}, 'indicative': {'type': 'boolean', 'description': "True when the total is plausible but not backed by the host's calendar, so it is an indicative price to be confirmed with the host."}}, 'description': 'Date-specific quote from the availability check, for the requested dates and party.', 'additionalProperties': False}, {'type': 'null'}]}, 'availability': {'enum': ['available', 'unavailable', 'unknown', 'not_checked'], 'type': 'string', 'description': 'available / unavailable for the requested dates; unknown = host confirms on inquiry; not_checked = no dates given or not verified.'}, 'reviews_count': {'type': 'number'}, 'price_from_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Indicative "from" nightly rate from the listing price list; per person or per property depending on the listing. Not the price for specific dates.'}, 'total_price_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Same as stay_price.total; null without a quote.'}, 'stay_price_withheld': {'type': 'string', 'description': 'Set when the offer is available but the booking system quoted a total that failed plausibility checks; total_price_pln and stay_price are then null and the price for the dates is to be confirmed with the host.'}}, 'additionalProperties': False}}, 'status': {'enum': ['ok', 'no_results', 'needs_more_info'], 'type': 'string'}, 'language': {'enum': ['pl', 'en'], 'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'When status=needs_more_info: the information missing for a search.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['message'], 'properties': {'message': {'type': 'string', 'description': "The accommodation request in the user's language (place, dates, guests, wishes) — no personal data."}, 'conversation_id': {'type': 'string', 'description': 'Conversation ID from a previous response; absent on the first turn.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['status', 'language', 'offers', 'questions'], 'properties': {'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['offer_id', 'name', 'city', 'image_url', 'rating', 'reviews_count', 'price_from_pln', 'availability', 'total_price_pln', 'stay_price', 'url'], 'properties': {'url': {'type': 'string', 'description': 'Offer page on noclegowo.pl (the URL carries attribution parameters).'}, 'city': {'type': 'string'}, 'name': {'type': 'string'}, 'nearby': {'type': 'object', 'required': ['from', 'distance_km'], 'properties': {'from': {'type': 'string', 'description': 'The requested location this offer is near.'}, 'distance_km': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Distance from the centre of the requested location, km.'}}, 'description': 'Present on an alternative from a neighbouring locality, included because few offers were available in the requested place for these dates; the offer is not in the requested place.', 'additionalProperties': False}, 'rating': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'offer_id': {'type': 'number'}, 'image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'why_match': {'type': 'string'}, 'stay_price': {'anyOf': [{'type': 'object', 'required': ['total', 'currency', 'nights', 'per_night', 'adults', 'children', 'date_from', 'date_to'], 'properties': {'total': {'type': 'number', 'description': 'Total for the whole stay and the whole party, PLN.'}, 'adults': {'type': 'number'}, 'nights': {'type': 'number'}, 'date_to': {'type': 'string'}, 'children': {'type': 'number'}, 'currency': {'type': 'string', 'const': 'PLN'}, 'date_from': {'type': 'string'}, 'per_night': {'type': 'number', 'description': 'total / nights, rounded — whole party.'}, 'indicative': {'type': 'boolean', 'description': "True when the total is plausible but not backed by the host's calendar, so it is an indicative price to be confirmed with the host."}}, 'description': 'Date-specific quote from the availability check, for the requested dates and party.', 'additionalProperties': False}, {'type': 'null'}]}, 'availability': {'enum': ['available', 'unavailable', 'unknown', 'not_checked'], 'type': 'string', 'description': 'available / unavailable for the requested dates; unknown = host confirms on inquiry; not_checked = no dates given or not verified.'}, 'reviews_count': {'type': 'number'}, 'price_from_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Indicative "from" nightly rate from the listing price list; per person or per property depending on the listing. Not the price for specific dates.'}, 'total_price_pln': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'description': 'Same as stay_price.total; null without a quote.'}, 'stay_price_withheld': {'type': 'string', 'description': 'Set when the offer is available but the booking system quoted a total that failed plausibility checks; total_price_pln and stay_price are then null and the price for the dates is to be confirmed with the host.'}}, 'additionalProperties': False}}, 'status': {'enum': ['ok', 'no_results', 'needs_more_info'], 'type': 'string'}, 'language': {'enum': ['pl', 'en'], 'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'When status=needs_more_info: the information missing for a search.'}, 'conversation_id': {'type': 'string', 'description': 'Opaque id of this search; accepted as conversation_id on a follow-up.'}}, 'additionalProperties': False}