{"openapi":"3.1.0","info":{"title":"Tokyo Events API","version":"1.0.0","description":"Upcoming events in Tokyo, updated daily, in English, Japanese, Russian and Chinese: concerts, festivals (matsuri), fireworks, exhibitions, pop-up stores, markets, sports, anime and tech events. Read-only, no key needed, 60 requests/minute per IP. Please link eventstokyo.com when you use the data.","contact":{"url":"https://eventstokyo.com/developers"}},"servers":[{"url":"https://eventstokyo.com/api/v1"}],"paths":{"/events":{"get":{"operationId":"searchEvents","summary":"Upcoming events, filtered","parameters":[{"name":"q","in":"query","description":"Free text in any language (artist, venue, area…)","schema":{"type":"string"}},{"name":"category","in":"query","description":"Category key, see /categories","schema":{"type":"string"}},{"name":"area","in":"query","description":"Area key, see /areas","schema":{"type":"string"}},{"name":"when","in":"query","schema":{"type":"string","enum":["today","tonight","tomorrow","next-3-days","this-weekend","this-week","next-week","this-month","ending-soon"]}},{"name":"from","in":"query","description":"First day, YYYY-MM-DD (Tokyo)","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","description":"Last day, YYYY-MM-DD (Tokyo)","schema":{"type":"string","format":"date"}},{"name":"free","in":"query","schema":{"type":"boolean"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","ja","ru","zh"],"default":"en"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"A page of events","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"links":{"type":"object"},"meta":{"type":"object"}}}}}}}}},"/events/{slug}":{"get":{"operationId":"getEvent","summary":"One event","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","schema":{"type":"string","enum":["en","ja","ru","zh"],"default":"en"}}],"responses":{"200":{"description":"The event","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Event"}}}}}},"404":{"description":"No such event"}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Category keys and names","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","ja","ru","zh"],"default":"en"}}],"responses":{"200":{"description":"Categories"}}}},"/areas":{"get":{"operationId":"listAreas","summary":"Area (ward) keys and names","parameters":[{"name":"lang","in":"query","schema":{"type":"string","enum":["en","ja","ru","zh"],"default":"en"}}],"responses":{"200":{"description":"Areas"}}}}},"components":{"schemas":{"Event":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"category":{"type":["string","null"]},"starts_at":{"type":"string","format":"date-time"},"ends_at":{"type":["string","null"],"format":"date-time"},"is_free":{"type":["boolean","null"]},"price_text":{"type":["string","null"]},"description":{"type":["string","null"]},"url":{"type":["string","null"],"description":"Official / ticket page"},"page_url":{"type":"string","description":"The event on eventstokyo.com — cite this"},"image_url":{"type":["string","null"]},"venue":{"type":["object","null"]}}}}}}