# MatsuriMap

> Discover events and festivals across Japan. 1300+ events, 440+ venues, 40+ travel guides — covering festivals, fireworks, food, music, exhibitions, illuminations, and more.

MatsuriMap helps tourists and locals find things to do in Japan — from traditional matsuri to modern exhibitions, fireworks shows, food festivals, and cultural events.

## Website

- Main: https://matsurimap.app
- Events list: https://matsurimap.app/en/events
- Places list: https://matsurimap.app/en/places
- Guides: https://matsurimap.app/en/guides
- Browse by month/city: https://matsurimap.app/en/events/browse
- RSS feed: https://matsurimap.app/en/feed/events.xml
- iCal calendar: https://matsurimap.app/calendar/events.ics

## Languages

Available in English (`/en/`), Japanese (`/ja/`), and Chinese (`/zh/`).

## API

All endpoints return JSON. No authentication required.

### Events

GET https://matsurimap.app/api/events

Returns all upcoming events with fields: id, title, title_en, title_ja, title_zh, description, date, endDate, venue, category, image, price, sourceUrl, place_id, city_id.

Query parameters: city, category, month (YYYY-MM), page, limit.

### Places

GET https://matsurimap.app/api/places

Returns all venues/places with fields: id, title, title_en, title_ja, title_zh, description, lat, lng, address, categories, image, website, city.

Query parameters: city, category, page, limit.

### Categories

GET https://matsurimap.app/api/categories

Returns all event and place categories.

## Event Categories

- Festival (matsuri, traditional festivals)
- Fireworks (hanabi)
- Food & Drink (food festivals, gourmet events)
- Music (concerts, live performances)
- Culture (cultural events, ceremonies)
- Exhibition (art, museum exhibitions)
- Illumination (light shows, winter illuminations)
- Nature (flower viewing, seasonal nature events)
- Performance (theater, dance, traditional arts)
- Sports (sporting events, marathons)

## Place Categories

Shrine, Temple, Park, Museum, Aquarium, Nature, Landmark, Entertainment, Arena, Onsen, Shopping

## Cities Covered

78+ cities across Japan including Tokyo, Osaka, Kyoto, Yokohama, Fukuoka, Sapporo, Nagoya, Kobe, Hiroshima, Sendai, Nara, Kanazawa, Nagasaki, Hakone, Nikko, Kamakura, Kawasaki, Chiba, Hakodate, Takayama, Okinawa, Kagoshima, Kumamoto, and more.

## Data

- 1300+ events (continuously updated via automated crawlers)
- 440+ places/venues
- 40+ trilingual travel guides
- Trilingual (EN/JA/ZH)
- Events include dates, locations, descriptions, and map coordinates
- Daily automated crawling from 160+ venue websites

## Links

- [Upcoming Events](https://matsurimap.app/en/events)
- [All Places](https://matsurimap.app/en/places)
- [Travel Guides](https://matsurimap.app/en/guides)
- [Map View](https://matsurimap.app/en)