Netsumiru EN
☰

Japan Sports Events API

Upcoming events in Japan as clean JSON: 405 pro sports games (every NPB baseball and J1 League football fixture, 32 teams, 34 stadiums) plus 2 curated major events — Grand Sumo tournaments, top fireworks festivals (hanabi) and major traditional festivals (matsuri), each verified against official sources. English names, verified station access, times in both UTC and JST, official ticket links. Built for travel apps, trip planners and AI agents. Data refreshed weekly from our automated collection pipeline (last update: 2026-09-13).

Endpoints

  • GET /api/v1 — API index & health (open)
  • GET /api/v1/games — list upcoming games. Filters: sport (baseball|soccer), league (npb-central|npb-pacific|j1), team (slug or name), venue (slug or name), city, date/from/to (YYYY-MM-DD, JST), limit (max 200), offset
  • GET /api/v1/games/{id} — a single game by stable numeric id
  • GET /api/v1/events — non-match events: category (sumo|fireworks|festival), city, from/to. Multi-day events (e.g. 15-day sumo tournaments) match any overlapping date range. Each event includes its official source URLs; timePrecision: "day" means no confirmed clock time.
  • GET /api/v1/teams — all teams with English/Japanese names and slugs
  • GET /api/v1/venues — all stadiums with English access directions

Try it now

https://www.netsumiru.jp/api/v1/games?sport=soccer&city=tokyo&limit=5

https://www.netsumiru.jp/api/v1/games?team=giants&from=2026-08-01&to=2026-08-31

Example response (one game, abridged):

{
 "meta": {
  "api": "Japan Sports Events API",
  "attribution": "Data compiled and verified by Netsumiru...",
  "totalMatched": 12, "returned": 1
 },
 "data": [{
  "id": 861,
  "sport": "soccer",
  "league": { "code": "j1", "en": "J1 League (J.League)" },
  "home": { "en": "Kashima Antlers", "short": "Antlers", "slug": "kashima" },
  "away": { "en": "Urawa Red Diamonds", "short": "Reds", "slug": "urawa" },
  "start": {
   "utc": "2026-08-08T10:00:00.000Z",
   "jst": "2026-08-08T19:00:00+09:00",
   "dateEn": "Saturday, August 8, 2026",
   "timeEn": "7:00 PM",
   "dayJst": "2026-08-08"
  },
  "venue": {
   "en": "Mercari Stadium (Kashima Soccer Stadium)",
   "city": "Kashima, Ibaraki",
   "accessEn": "About 2 minutes on foot from Kashima Soccer Stadium Station...",
   "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=..."
  },
  "tickets": {
   "officialEnglishPortal": "https://quick.pia.jp/qp_jleague_en/",
   "buyingGuide": "https://www.netsumiru.jp/en/tickets"
  },
  "guidePage": null
 }]
}

What makes this dataset different

  • One normalized feed across leagues. NPB clubs and J.League clubs publish schedules in different places, formats and languages. We collect from 20+ sources daily, normalize venue naming-rights changes, deduplicate home/away listings and serve one consistent English schema.
  • Verified English stadium access. The accessEn lines (nearest station, walking time) are human-verified translations of the same data that powers our matchday guides — not machine-translated guesses.
  • Agent-friendly. Stable ids, ISO 8601 timestamps in UTC and JST, explicit dayJst calendar keys, and CORS enabled — drop it straight into a travel planner, chatbot tool call, or calendar integration.

Terms of use

  • Free during the launch period for evaluation and low-volume use. A marketplace listing with metered tiers is planned; this page will link to it.
  • Attribution required: display “Data: Netsumiru” with a link to https://www.netsumiru.jp/en wherever the data is shown to end users.
  • Game facts (dates, venues, match-ups) are public facts; this compilation, its normalization and English enrichment are maintained by Netsumiru. Schedules can change — always link users to official ticket channels for the final word.
  • No scraping of this website's HTML; use the API.

Questions, higher-volume needs, or a custom feed (hotels, demand calendars, additional leagues)? Contact us via the address on the site home.