# Japanese Annual Events & Festivals by Month

> Japanese Annual Events & Festivals by Month is a paid API for AI agents from jp-data-api-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns a list of Japanese annual events and matsuri (festivals) for a given month or all months, including name, date/season, location, and English descriptions.

## Facts

- Endpoint: GET https://jp-data-api-production.up.railway.app/culture/events
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japanese-annual-events-festivals-by-month-53d05f23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ISNPa2fHFGI29N_EooZUs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability japanese-annual-events-festivals-by-month-53d05f23
```

Example prompt: What major Japanese festivals and annual events happen in August? Give me their names, dates, locations, and a brief description in English.

## When to prefer this

Use this endpoint when you need structured English-language data about Japanese cultural events, festivals, and matsuri organized by month — ideal for travel itinerary planning, cultural guides, or event calendars focused on Japan. Prefer this over generic web search when you need clean, structured data rather than scraped articles.

## Known failure modes

- Invalid month value (not 1-12) may return an error or empty results
- No events found for a specific month returns an empty list
- Service downtime on Railway hosting returns a 5xx error
- Payment not fulfilled returns HTTP 402 with payment requirements

## How this service works

Japanese annual events and festivals (matsuri) by month: name, date/season, location, description in English. For inbound travel timing, cultural guides, event planning.

## Output

A list of Japanese annual events and festivals for the requested month (or all months if no month is specified), each with the event name, date or seasonal timing, location in Japan, and an English-language description — suitable for travel planning or cultural reference.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "month": {
       "type": "string",
       "description": "1-12, or omit for all"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japanese-annual-events-festivals-by-month-53d05f23/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jp-data-api-production.up.railway.app](https://www.zero.xyz/host/jp-data-api-production.up.railway.app/llms.txt)