Raw schema
{
"type": "object",
"properties": {
"city": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Russian city exactly as the user named it: 'Москва', 'мск', 'Питер', 'СПб', 'в Казани', 'Нижний Новгород', or a slug like 'spb'. Required unless `near` is given; there is no default city."
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Optional free text: performer, show title, venue, genre or topic — 'Щелкунчик', 'джаз', 'Большой театр', 'выставка Айвазовского', 'Би-2'. Omit it to browse by filters only."
},
"when": {
"type": "string",
"enum": [
"today",
"tomorrow",
"weekend",
"week"
],
"description": "Date preset in the city's local time: today; tomorrow; weekend = the nearest Saturday–Sunday (on Sunday it means the next weekend); week = the next 7 days. For other dates use date_from/date_to. Exhibitions and festivals running during the dates are included."
},
"date_from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, YYYY-MM-DD, city-local, e.g. '2026-11-07'. Use with date_to."
},
"date_to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day inclusive, YYYY-MM-DD, city-local. Same as date_from for a single day."
},
"time_of_day": {
"type": "string",
"enum": [
"morning",
"day",
"evening",
"night"
],
"description": "Start time window, city-local: morning 06–12, day 12–18, evening 18–24, night 21–24. Matches sessions that start in the window; all-day items and exhibitions already running are left out."
},
"time_from": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Earliest start time HH:MM, e.g. '19:00' for «после семи». Overrides time_of_day."
},
"time_to": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Latest start time HH:MM. May be earlier than time_from for windows across midnight."
},
"categories": {
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"enum": [
"music",
"standup",
"theatre",
"cinema",
"exhibition",
"art",
"sport",
"festival",
"lecture",
"kids",
"party",
"food",
"tour",
"games",
"dating",
"workshop",
"outdoor",
"ballet",
"circus",
"other"
]
},
"description": "Event categories, any of: music = concerts; standup; theatre; cinema; exhibition = exhibitions & museums; art; sport; festival; lecture = lectures & talks; kids = for children & families; party = parties & DJ sets; food = food & tastings; tour = excursions & city tours; games = quests & board games; dating; workshop = master classes; outdoor = active leisure; ballet = ballet & opera; circus = circus & shows; other. For children use kids."
},
"free_only": {
"type": "boolean",
"description": "Only free events (вход свободный, бесплатно)."
},
"price_max": {
"type": "integer",
"minimum": 0,
"maximum": 1000000,
"description": "Maximum ticket price in rubles. Events with an unknown price are kept."
},
"near": {
"type": "object",
"properties": {
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"lon": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius_km": {
"description": "Search radius, km. Default 3.",
"type": "number",
"minimum": 0.3,
"maximum": 25
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false,
"description": "Search around a point: coordinates of a shared location or of a place whose coordinates are known. For a city as a whole there is `city`."
},
"sort": {
"description": "relevance (default with `query`), popular (default without it), soonest, price (cheapest first).",
"type": "string",
"enum": [
"relevance",
"soonest",
"popular",
"price"
]
},
"limit": {
"description": "How many events to return, 1–20. Default 8.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"description": "`next_cursor` from the previous result of the same search, to get more events.",
"type": "string",
"maxLength": 512
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}