🌸 🍁 🏮

Japan Seasons API

Cherry blossoms, autumn foliage & festivals — one API for AI agents and developers

Terminal

$ curl https://jpseasons.dokos.dev/v1/sakura/status?station=tokyo

{
  "station": "Tokyo",
  "status": "full_bloom",
  "date": "2025-03-26",
  "species": "Somei-Yoshino"
}

Three APIs, One Endpoint

Comprehensive seasonal data for Japan, updated daily from official sources.

🌸

Sakura

57 observation stations across Japan. 73 years of historical bloom data. Real-time status & forecasts from JMA.

Status Forecast Historical Recommend

🍁

Kouyou

53 stations tracking autumn foliage across Japan. Color-change status, peak dates, and seasonal recommendations.

Status Forecast Historical Recommend

🏮

Matsuri

50+ curated Japanese festivals. Search by region, month, or keyword. Rich metadata including locations & dates.

Search By Region By Month

Quick Start

Get started in seconds. No SDK required.

# Get sakura bloom status
$ curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://jpseasons.dokos.dev/v1/sakura/status?station=tokyo"

# Search festivals in Kyoto
$ curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://jpseasons.dokos.dev/v1/matsuri?region=kinki"

# Get kouyou forecast
$ curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://jpseasons.dokos.dev/v1/kouyou/forecast?station=nikko"

const response = await fetch(
  "https://jpseasons.dokos.dev/v1/sakura/status?station=tokyo",
  {
    headers: {
      "Authorization": `Bearer ${API_KEY}`
    }
  }
);

const data = await response.json();
console.log(data.station);  // "Tokyo"
console.log(data.status);   // "full_bloom"

import requests

response = requests.get(
    "https://jpseasons.dokos.dev/v1/sakura/status",
    params={"station": "tokyo"},
    headers={"Authorization": f"Bearer {API_KEY}"}
)

data = response.json()
print(data["station"])  # Tokyo
print(data["status"])   # full_bloom

AI-Native

Works with AI Agents

Connect via Model Context Protocol (MCP). 10 built-in tools for sakura, kouyou, and matsuri data — ready for Claude, GPT, and any MCP-compatible agent.

claude_desktop_config.json

{
  "mcpServers": {
    "japan-seasons": {
      "url": "https://jpseasons.dokos.dev/mcp"
    }
  }
}

Claude Code CLI

claude mcp add --transport http japan-seasons https://jpseasons.dokos.dev/mcp

Available Tools

🌸 get_sakura_status · get_sakura_forecast
🌸 get_sakura_historical · get_sakura_locations
🍁 get_kouyou_status · get_kouyou_forecast
🍁 get_kouyou_locations
🏮 search_matsuri · get_matsuri_by_region
📍 recommend_spots

Example Prompts

"When will cherry blossoms bloom in Tokyo?"
"What festivals are happening in Kyoto in July?"
"Show me autumn foliage spots near Nikko"
"Compare sakura bloom dates over the last 10 years"

Simple Pricing

Start free. Scale when you need to.

Free

$0/mo

✓ 100 requests / day
✓ Current year data
✓ All basic endpoints
✓ MCP access

Start Free

Popular

Pro

$29/mo

✓ 10,000 requests / day
✓ 73 years historical data
✓ Webhooks
✓ Priority MCP

Get Pro

Enterprise

Custom

✓ 100,000+ requests / day
✓ SLA guarantee
✓ Priority support
✓ Custom integrations