Datasets

Download datasets exported from the database in CSV format. Datasets are exported daily at midnight UTC.

Songs

Cross-sectional data about songs, which is shared metadata for groups of charts.

Columns Included

id, title, title_en, title_romaji, alternate_titles, charters, uploader, credits, format, display_bpm, preview_image, background_image, file_size, lyrics, meta, download_available, description, downloads, likes, dislikes, weighted_rating, unique_plays, favorites, source, status, creation_date, last_modified, last_check

Ratings

Time-series data of user ratings of songs over time.

Columns Included

song_id, date, likes, dislikes, downloads, favorites

Song Diffs

History of changes made to song metadata between updates.

Columns Included

version, song_id, date, event_changes, meta_changes

Charts

Cross-sectional data about individual charts, not including computed data that depends on the game engine they are played in.

Columns Included

song_id, difficulty_name, difficulty_level, targets, holds, sustains, sliders, slide_chains, multis, multi_summary, hearts, doubles, rushes, max_bpm, min_bpm, bpm_changes, nps_peak, nps_median, nps_series, duration, sha1, unique_plays, meta

Game Data

Cross-sectional data about charts where the computed value is dependent on the game engine the chart is running in.

Columns Included

song_id, difficulty_name, game_engine, max_combo, max_score, base_score, score_summary, score_attack, score_attack_steps, max_percent, base_percent, percent_summary, percent_attack, percent_attack_steps

Chart Diffs

History of changes made to charts between updates.

Columns Included

version, song_id, difficulty_name, date, event_changes, meta_changes

Project Heartbeat Leaderboard

Complete dataset of leaderboard entries for Project Heartbeat.

Columns Included

entry_id, song_id, difficulty_name, steam_id, time, current_rank, max_rank, total_score, hold_score, slide_score, rush_score, percent, best_combo, cools, fines, safes, sads, worsts, total_wrongs, wrongs