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_checkRatings
Time-series data of user ratings of songs over time.
Columns Included
song_id, date, likes, dislikes, downloads, favoritesSong Diffs
History of changes made to song metadata between updates.
Columns Included
version, song_id, date, event_changes, meta_changesCharts
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, metaGame 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_stepsChart Diffs
History of changes made to charts between updates.
Columns Included
version, song_id, difficulty_name, date, event_changes, meta_changesProject Heartbeat Leaderboard
Complete dataset of leaderboard entries for Project Heartbeat.
Columns Included
entry_id, song_id, difficulty_name, steam_id, start_time, time, current_rank, max_rank, total_score, hold_score, slide_score, rush_score, percent, best_combo, cools, fines, safes, sads, worsts, total_wrongs, wrongs