BitBusters.club API Documentation
We provide free access to our Chip's Challenge data for use in non-commercial applications
GET
Levels
Fetches properties (title, password, designer, time limit, etc.) of official level packs, community level packs and all levels within these packs
Lookup URLs
/packs
: summary for all packs tracked on the scores
site [example lookup]
pack
: unique alphanumeric identifier for the pack, one of cc1, cclp1, cclp2, cclp3, cclp4, cc2, cc2lp1, cclp5long_desc
: full name for the level packshort_desc
: shorter abbreviated name for the level packlevel_count
: number of levels in the packvalid_configs
: array of valid rule type and metric configurations for the packrule_type
: all tracked rule types for this pack, one of ms, lynx, steammetric
: all tracked metrics for this pack, one of time, score
/packs/<pack>
: summary for one specific level pack, same output as full pack lookup
above [example lookup]
/packs/<pack>/levels
: listing of all levels within one specific pack [example lookup]
level
: numeric level identifier, unique within the same packname
: level titlegame
: game identifier (CC1/CC2)pack
: level pack identifierdesigners
: comma-separated list of level designer namesadapted
: boolean, true if the level's design was adapted from another work otherwise falsepassword
(optional): 4-letter password for CC1 levelspassword_note
(optional): special notes regarding the password, such as password differences between rule typestime_limit
: the level's time limit, 0 if unlimited timechips_required
: the number of chips which must be collected to clear a socket in the level, if one is presenttotal_chips
: the total number of chips available in the levelchips_note
(optional): special notes regarding chips required or total chips, such as differences between rule types or whether the level can be solved without picking up all required chipswiki_article
: a link to the level's Bit Busters wiki articlems_map
(optional): a link to a map of the level using the Microsoft tileset, if applicabletw_map
(optional): a link to a map of the level using the Tile World tileset, if applicablesteam_map
(optional): a link to a map of the level using the Steam tileset, if applicablelevel_attribs
: array of additional level attributes which may differ between rule type and metricrule_type
: rule type identifier for the attributes that follow, one of {ms, lynx, steam}metric
: metric identifier for the attributes that follow, one of {time, score}attribs
: array containing additional level attributesmelinda
: the highest theoretically possible scorehighest_reported
: the highest reported score to date, also known as the bold scorehighest_public
: the highest score reported to an official public repo to date, if public scores are tracked for the packhighest_confirmed
: the highest confirmed score to date, if confirmed scores are tracked for the pack. NULL if no confirmed score yetcasual_diff
: difficulty for a casual player to solve this level for the first time, a rating between 1 and 5exec_diff
: difficulty to execute the bold route for this level, a rating between 1 and 5luck_diff
: additional difficulty for executing the bold route due to the presence of luck elements, a rating between 1 and 5 or 0 if the level contains no luck elementsrouting_diff
: difficulty to find the bold route for this level, a rating between 1 and 5
/packs/<pack>/levels/<level number>
: summary for one specific level, same
output as full level listing above [example lookup]
GET
Custom Packs
Fetches information of any custom level packs in our database and all levels within these packs
Lookup URLs
/custom-packs
: a listing of all custom packs [example lookup]
id
: unique numeric identifier for the packpack_name
: full name for packdisplay_name
: for CC2 packs, this is the game name specified in the .c2g filegame
: one of CC1 or CC2pack_type
: type of pack, one of Regular set, Official set, Competition set, Voting pack, Compilation set, Rediscovered set, Bug demonstration, Official set variant, Official set modlevel_count
: number of levels contained within the packdescription
: a description for the pack set by the pack authorrelease_date
: the datetime the pack was added to the databaselast_updated
: last modified datetime of the pack in the databasefile_name
: name of the pack filefile_size
: size of the pack file in bytesdownload_url
: a URL to download the pack. For CC1 packs, this will be a .dat or .ccl file. For CC2 packs, this will be a .zip file. NULL if the set is not authorized for download by the author or for copyright reasons
/custom-packs/<cc1|cc2>
: a listing of all customer packs within only CC1 or CC2, same output as full pack lookup
above [example lookup]
/custom-packs/<cc1|cc2>/<pack_id>
: summary for one specific level pack, same output as full pack lookup
above [example lookup]
/custom-packs/<cc1|cc2>/<pack_id>/levels
: listing of all levels within one specific pack [example lookup]
level
: numeric level identifier, unique within the same packname
: level titledesigner
: the name of the level designer, which may differ from the pack owner. For CC1 packs, this is the author field in the .dat file. For CC2 packs, this is the author field in the .c2m filepassword
: 4-letter password for CC1 levelstime_limit
: the level's time limit, 0 if unlimited timechips_required
: the number of chips which must be collected to clear a socket in the level, if one is presenttotal_chips
: the total number of chips available in the levelwidth
: width of the level in tilesheight
: height of the level in tileshint
: hint appearing within the level, if anydownload_url
: only valid for CC2 levels, direct download for the level's .C2M file
GET
Players
Fetches information about players/level designers tracked on the Chip's Challenge high scores at scores.bitbusters.club
Lookup URLs
/players
: summary of all players tracked on the scores site [example lookup]
/players/<id>
: summary for one specific player [example lookup]
player_id
: unique numeric identifier for playerplayer
: preferred player namedesigner
(optional): preferred credited name for level design purposes, if different from playerother_names
(optional): other aliases this player may go bycountry
(optional): player's country of residencescore_summary
: summary of scores submitted by player, empty array if no scores submittedpack
: unique alphanumeric identifier for the pack, one of {cc1, cclp1, cclp2, cclp3, cclp4, cc2, cc2lp1, cclp5}rule_type
: all tracked rule types for this pack, one of {ms, lynx, steam}metric
: all tracked metrics for this pack, one of {time, score}avg_ranking
: average level ranking achieved within the packcalc_score
: sum of scores achieved on all levels for the full packbold_count
: number of bolds achieved within the pack
designed_levels
: summary of levels designed by player, empty array if no levels designedpack
: unique alphanumeric identifier for the pack, one of {cc1, cclp1, cclp2, cclp3, cclp4, cc2, cc2lp1, cclp5}level_count
: number of levels designed in this pack