Place to Be

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The event id, or its placetobe.cc/place/... URL.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'title', 'category', 'when', 'time_announced', 'starts_at', 'ends_at', 'timezone', 'status', 'venue', 'area', 'city', 'country', 'score', 'tier', 'reason', 'url', 'source_url', 'subtitle', 'description', 'address', 'lat', 'lng', 'image', 'attribution'], 'properties': {'id': {'type': 'string', 'description': 'Stable event id (use with get_event).'}, 'lat': {'type': ['number', 'null']}, 'lng': {'type': ['number', 'null']}, 'url': {'type': 'string', 'description': "The event's page on placetobe.cc."}, 'area': {'type': ['string', 'null'], 'description': 'Neighbourhood or area of the venue.'}, 'city': {'type': ['string', 'null']}, 'tier': {'type': 'string', 'description': 'The score as a word: Legendary, Hot right now, Rising, Notable or On the radar.'}, 'when': {'type': 'string', 'description': "Local date and time at the event, e.g. 'Sat 3 Oct, 20:00'."}, 'image': {'type': ['string', 'null']}, 'score': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'How big a moment it is (expected crowd and timing).'}, 'title': {'type': 'string'}, 'venue': {'type': ['string', 'null']}, 'reason': {'type': ['string', 'null'], 'description': 'One line on why it scores as it does.'}, 'status': {'enum': ['live', 'soon', 'upcoming', 'ongoing', 'ended'], 'type': 'string'}, 'address': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null']}, 'ends_at': {'type': ['string', 'null'], 'description': 'End, ISO 8601, when published.'}, 'category': {'enum': ['music', 'nightlife', 'festival', 'sports', 'culture', 'food', 'community', 'other'], 'type': 'string'}, 'subtitle': {'type': ['string', 'null']}, 'timezone': {'type': ['string', 'null'], 'description': 'IANA time zone of the venue.'}, 'starts_at': {'type': ['string', 'null'], 'description': 'Start, ISO 8601.'}, 'source_url': {'type': ['string', 'null'], 'description': 'The ticketing or official page the listing came from.'}, 'attribution': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null'], 'description': "The source's description, trimmed."}, 'time_announced': {'type': 'boolean', 'description': 'False when the source published a date but no start time.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Part of a city name, e.g. "san" or "York".'}, 'country': {'type': 'string', 'description': 'English country name or ISO 3166-1 alpha-2 code.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['total_cities', 'count', 'cities'], 'properties': {'count': {'type': 'integer', 'minimum': 0}, 'cities': {'type': 'array', 'items': {'type': 'object', 'required': ['city', 'country', 'country_name', 'events', 'url'], 'properties': {'url': {'type': 'string'}, 'city': {'type': 'string'}, 'events': {'type': 'integer', 'minimum': 0}, 'country': {'type': ['string', 'null'], 'description': 'ISO 3166-1 alpha-2.'}, 'country_name': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'total_cities': {'type': 'integer', 'minimum': 0, 'description': 'Cities with a live board, before filtering.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'City name in English, e.g. "London", "New York", "Mexico City". Add the country after a comma when a name is shared ("Paris, France"). Omit city and country for worldwide. For the major cities, results also include the big events just outside the city line (SoFi Stadium in Inglewood for Los Angeles, MetLife Stadium for New York); each result names its own town.'}, 'sort': {'enum': ['biggest', 'soonest'], 'type': 'string', 'default': 'biggest', 'description': 'biggest: highest score first. soonest: earliest start first.'}, 'when': {'enum': ['now', 'tonight', 'this_weekend', 'this_week', 'upcoming'], 'type': 'string', 'default': 'upcoming', 'description': 'now: on right now. tonight: the rest of today, local time. this_weekend: Friday 17:00 to Sunday night, local time. this_week: the next 7 days. upcoming: the next 160 days.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'How many events, 1 to 25.'}, 'query': {'type': 'string', 'description': 'Only events whose title or venue contains this text: an artist, team, show or venue name, e.g. "Coldplay", "Arsenal", "Madison Square Garden". At least 2 characters.'}, 'country': {'type': 'string', 'description': 'A whole country instead of one city: English name or ISO 3166-1 alpha-2 code ("Netherlands", "NL"). Ignored when city is given.'}, 'categories': {'type': 'array', 'items': {'enum': ['music', 'nightlife', 'festival', 'sports', 'culture', 'food', 'community', 'other'], 'type': 'string'}, 'description': 'Only these kinds of events. Omit for all.', 'uniqueItems': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['scope', 'query', 'when', 'sort', 'count', 'board_url', 'events', 'attribution'], 'properties': {'sort': {'enum': ['biggest', 'soonest'], 'type': 'string'}, 'when': {'enum': ['now', 'tonight', 'this_weekend', 'this_week', 'upcoming'], 'type': 'string'}, 'count': {'type': 'integer', 'minimum': 0}, 'query': {'type': ['string', 'null'], 'description': 'The name filter, when one was given.'}, 'scope': {'type': 'string', 'description': "Where: a city, a country, or 'worldwide'."}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'category', 'when', 'time_announced', 'starts_at', 'ends_at', 'timezone', 'status', 'venue', 'area', 'city', 'country', 'score', 'tier', 'reason', 'url', 'source_url'], 'properties': {'id': {'type': 'string', 'description': 'Stable event id (use with get_event).'}, 'url': {'type': 'string', 'description': "The event's page on placetobe.cc."}, 'area': {'type': ['string', 'null'], 'description': 'Neighbourhood or area of the venue.'}, 'city': {'type': ['string', 'null']}, 'tier': {'type': 'string', 'description': 'The score as a word: Legendary, Hot right now, Rising, Notable or On the radar.'}, 'when': {'type': 'string', 'description': "Local date and time at the event, e.g. 'Sat 3 Oct, 20:00'."}, 'score': {'type': 'integer', 'maximum': 100, 'minimum': 0, 'description': 'How big a moment it is (expected crowd and timing).'}, 'title': {'type': 'string'}, 'venue': {'type': ['string', 'null']}, 'reason': {'type': ['string', 'null'], 'description': 'One line on why it scores as it does.'}, 'status': {'enum': ['live', 'soon', 'upcoming', 'ongoing', 'ended'], 'type': 'string'}, 'country': {'type': ['string', 'null']}, 'ends_at': {'type': ['string', 'null'], 'description': 'End, ISO 8601, when published.'}, 'category': {'enum': ['music', 'nightlife', 'festival', 'sports', 'culture', 'food', 'community', 'other'], 'type': 'string'}, 'timezone': {'type': ['string', 'null'], 'description': 'IANA time zone of the venue.'}, 'starts_at': {'type': ['string', 'null'], 'description': 'Start, ISO 8601.'}, 'source_url': {'type': ['string', 'null'], 'description': 'The ticketing or official page the listing came from.'}, 'time_announced': {'type': 'boolean', 'description': 'False when the source published a date but no start time.'}}, 'additionalProperties': False}}, 'board_url': {'type': 'string', 'description': 'The live board for this place on placetobe.cc.'}, 'attribution': {'type': ['string', 'null']}}, 'additionalProperties': False}