API

A public, machine-readable database of every song currently playable on CHUNITHM International, one entry per song with one object per live chart. Unreleased, deleted, and banned songs are not included; availability is maintained against CHUNITHM-NET itself.

The endpoint needs no authentication and CORS is open, so it can be called from servers, scripts, and browser code alike. The database updates automatically alongside site data; new songs usually appear the day they are added.

Synopsis

$ curl -I --compressed https://chunimaru.fuwamofu.net/api/songdb/intl

HTTP/2 200
content-type: application/json; charset=utf-8
content-encoding: gzip
content-length: 168819
etag: W/"f334bb52036831a6a0f8dfb489ca4be9a2cea5e9"
cache-control: public, max-age=300
x-ratelimit-limit: 30
x-ratelimit-remaining: 29
access-control-allow-origin: *
vary: Accept-Encoding

Request

GET returns the full document. HEAD returns the same headers with no body. There is no authentication and there are no query parameters. Both request headers below are optional but strongly recommended.

Response

Rate Limit

Currently 30 requests per hour per IP address (fixed window), and 304 responses count too; the X-RateLimit-Limit header on every response is the authoritative value. Exceeding the limit returns 429 with a Retry-After header, and X-RateLimit-Remaining shows where you stand.

The data changes at most a few times a week. Cache the file, revalidate with If-None-Match, and poll no faster than hourly; anything more gains nothing.

Schema

formatVersion is currently 1 and only changes on breaking schema changes; pin against it if you parse the document programmatically. Field names below are literal.

{
  "format": "chunimaru-songdb",
  "formatVersion": 1,
  "generatedAt": "2026-08-05T08:57:14+00:00",
  "server": "intl",
  "gameVersion": "X-Verse-X",
  "newSongCutoff": "2025-12-10",
  "songs": [
    {
      "idx": 2948,
      "id": "b6144bf73037e116",
      "title": "THE TRiANGLE",
      "artist": "Yuta Imai",
      "genre": "ゲキマイ",
      "bpm": 230,
      "release": "2026-07-30",
      "releaseVersion": "CHUNITHM X-VERSE-X",
      "releaseVersionValue": "20",
      "isNew": true,
      "img": "773b590c9a43452c",
      "jacket": "https://reiwa.f5.si/jackets/chunithm/773b590c9a43452c.webp",
      "charts": {
        "EXP": { "level": 13, "levelDisplay": "13", "const": 13.3, "maxCombo": 1919, "isConstUnknown": false },
        "MAS": { "level": 15, "levelDisplay": "15", "const": 15, "maxCombo": 2709, "isConstUnknown": false }
      }
    }
  ]
}

Examples

curl -s --compressed -o songdb.json \
  https://chunimaru.fuwamofu.net/api/songdb/intl

# first fetch: keep the ETag from the response headers
curl -s -D headers.txt --compressed -o songdb.json \
  https://chunimaru.fuwamofu.net/api/songdb/intl
grep -i '^etag:' headers.txt

# later: 304 means your copy is still current
curl -s --compressed -o songdb.json -w "%{http_code}\n" \
  -H 'If-None-Match: W/"PASTE-ETAG-VALUE-HERE"' \
  https://chunimaru.fuwamofu.net/api/songdb/intl

const res = await fetch("https://chunimaru.fuwamofu.net/api/songdb/intl");
if (!res.ok) throw new Error("HTTP " + res.status);
const db = await res.json();
console.log(db.gameVersion, db.songCount + " songs");

U=https://chunimaru.fuwamofu.net/api/songdb/intl

curl -s --compressed $U | jq '.songCount'
curl -s --compressed $U | jq '[.songs[] | select(.isNew)] | length'
curl -s --compressed $U | jq -r '.songs[] | select(.charts.MAS.const >= 15.5) | .title'

Notes

• Some charts carry isConstUnknown: true, community-estimated constants, mostly on lower difficulties. Treat those values as approximate.
• Membership means playable on the INTL cabinet right now. Per-account unlock state is not modeled.
• Data is community-maintained and provided as is. Chart data originates from the reiwa/chunirec dataset; availability is checked against CHUNITHM-NET.
• Not affiliated with SEGA. CHUNITHM is a trademark of SEGA.