Input schema (JSON)
{
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Trip end, YYYY-MM-DD: events that have started by this day."
},
"from": {
"type": "string",
"description": "Trip start, YYYY-MM-DD: events running on or after this day."
},
"sort": {
"enum": [
"soonest",
"size",
"distance"
],
"type": "string",
"description": "Order of results."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many events to return (default 10)."
},
"query": {
"type": "string",
"description": "Words in the name, place or description, e.g. 'Harbin', 'Kyoto', 'lantern'."
},
"sizes": {
"type": "array",
"items": {
"enum": [
"Mega",
"Major",
"Notable"
],
"type": "string"
},
"description": "Mega: about a million visitors or more or a national flagship; Major: about 200,000 to a million; Notable: smaller."
},
"types": {
"type": "array",
"items": {
"enum": [
"light",
"lantern",
"drone",
"projection",
"immersive",
"parade",
"fireworks",
"ice",
"balloon",
"sand",
"animals",
"battles",
"contests",
"cultural"
],
"type": "string"
},
"description": "Types of spectacle: light (Light festivals and light art), lantern (Lanterns), drone (Drone shows), projection (Projection mapping), immersive (Immersive venues), parade (Parades and carnivals), fireworks (Fireworks), ice (Ice and snow), balloon (Balloons and kites), sand (Sand sculpture), animals (Animal spectacles), battles (Food fights and mass battles), contests (Odd contests and races), cultural (Cultural festivals)."
},
"region": {
"type": "string",
"description": "One of: East Asia, Southeast Asia, South Asia, Middle East and Central Asia, Europe, North America, Latin America and the Caribbean, Africa, Oceania."
},
"country": {
"type": "string",
"description": "ISO 3166 country code (e.g. JP) or country name."
},
"near_lat": {
"type": "number",
"description": "Latitude of a place to search around."
},
"near_lng": {
"type": "number",
"description": "Longitude of a place to search around."
},
"radius_km": {
"type": "number",
"description": "Search radius around near_lat/near_lng in km (default 250)."
},
"year_round": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Venues open all year and regular shows without a season: include them (default), exclude them, or return only them."
},
"confirmed_only": {
"type": "boolean",
"description": "Only events whose dates the organizer has published."
}
}
}