API documentation

All the informations and details about Worldwide Combos games modes and rankings.

This API is under construction. More features will be added in the future.

In order to use this API, just send a request to https://api.worldwide-combos.com/name after replacing name by the method's name.

NameDescription
profileRetrieve a validated player's profile informations
onlineRetrieve the list of players that are currently online.
rankingsRetrieve Worldwide Combos rankings with some optional filters.

profile

This is to retrieve a validated player's profile informations.

Parameters

NameOptionalDescription
usernamenoThe username of the player you are interested in.

Example: https://api.worldwide-combos.com/profile?username=noelnadal.

Response fields

Each response contains a warning field and an error field. If the error attribute is an empty string, then there is another field called profile, which is a collection with the following fields.

NameTypeDescription
usernamestringThe username of the player you queried.
countrystringThe country of the player you queried.
registration_datestringThe registration date and time (UTC) of the player you queried.
last_loginstringThe last time (UTC) the player you queried was online.
NL_ratingfloatThe No Limit rating of the player you queried.
TL_ratingfloatThe Tuning Limit rating of the player you queried.
elo424floatThe No Limit Basic Holes rating of the player you queried.
elo425floatThe No Limit Basic Bombs rating of the player you queried.
elo426floatThe No Limit Chaos Holes rating of the player you queried.
elo427floatThe No Limit Chaos Bombs rating of the player you queried.
elo428floatThe No Limit Deadline Holes rating of the player you queried.
elo429floatThe No Limit Deadline Bombs rating of the player you queried.
elo430floatThe Tuning Limit Basic Holes rating of the player you queried.
elo431floatThe Tuning Limit Basic Bombs rating of the player you queried.
elo432floatThe Tuning Limit Chaos Holes rating of the player you queried.
elo433floatThe Tuning Limit Chaos Bombs rating of the player you queried.
elo434floatThe Tuning Limit Deadline Holes rating of the player you queried.
elo435floatThe Tuning Limit Deadline Bombs rating of the player you queried.
spnl7integerThe No Limit 7-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
spnl21integerThe No Limit 21-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
spnl1integerThe No Limit 1-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
sptl7integerThe Tuning Limit 7-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
sptl21integerThe Tuning Limit 21-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
sptl1integerThe Tuning Limit 1-bag Sprint Personal Best of the player you queried, in milliseconds (0 if none).
hsnl7integerThe No Limit 7-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
hsnl21integerThe No Limit 21-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
hsnl1integerThe No Limit 1-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
hstl7integerThe Tuning Limit 7-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
hstl21integerThe Tuning Limit 21-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
hstl1integerThe Tuning Limit 1-bag Holes Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bsnl7integerThe No Limit 7-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bsnl21integerThe No Limit 21-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bsnl1integerThe No Limit 1-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bstl7integerThe Tuning Limit 7-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bstl21integerThe Tuning Limit 21-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
bstl1integerThe Tuning Limit 1-bag Bombs Survivor Personal Best of the player you queried, in milliseconds (0 if none). Four minutes are added to Advanced runs, and eight minutes are added to Elite runs.
grnl7integerThe No Limit 7-bag Gravity Personal Best of the player you queried (0 if none).
grnl21integerThe No Limit 21-bag Gravity Personal Best of the player you queried (0 if none).
grnl1integerThe No Limit 1-bag Gravity Personal Best of the player you queried (0 if none).
grtl7integerThe Tuning Limit 7-bag Gravity Personal Best of the player you queried (0 if none).
grtl21integerThe Tuning Limit 21-bag Gravity Personal Best of the player you queried (0 if none).
grtl1integerThe Tuning Limit 1-bag Gravity Personal Best of the player you queried (0 if none).
twitchstringThe Twitch channel of the player you queried, if it is public, or an empty string otherwise.
genderstringThe gender of the player you queried, either "Male", "Female", "Other" or "Unknown".
namestringThe name of the player you queried, if it is known, or an empty string otherwise.
surnamestringThe surname of the player you queried, if it is known, or an empty string otherwise.

This is what you could get with the query above.

{
  "warning": "",
  "error": "",
  "profile": {
    "pseudo": "noelnadal",
    "pays": "France",
    "registration_date": "Thu May 25 2017 22:17:11",
    "last_login": "Fri May 28 2021 16:55:21",
    "NL_rating": 0,
    "TL_rating": 9947.81,
    "elo424": 861.578,
    "elo425": 814.128,
    "elo426": 793.301,
    "elo427": 832.009,
    "elo428": 874.659,
    "elo429": 744.198,
    "elo430": 849.09,
    "elo431": 870.93,
    "elo432": 846.629,
    "elo433": 800,
    "elo434": 861.284,
    "elo435": 800,
    "bsnl7": 301318,
    "bsnl21": 1609,
    "bsnl1": 0,
    "bstl7": 72526,
    "bstl21": 0,
    "bstl1": 0,
    "hsnl7": 175257,
    "hsnl21": 0,
    "hsnl1": 0,
    "hstl7": 0,
    "hstl21": 0,
    "hstl1": 0,
    "spnl7": 37790,
    "spnl21": 45408,
    "spnl1": 0,
    "sptl7": 0,
    "sptl21": 0,
    "sptl1": 0,
    "grnl7": 127,
    "grnl21": 0,
    "grnl1": 0,
    "grtl7": 0,
    "grtl21": 0,
    "grtl1": 0,
    "twitch": "noelnadal",
    "nom": "Nadal",
    "prenom": "Noël",
    "discord": "noelnadal#3933",
    "gender": "Male"
  }
}

online

This is to retrieve the number of players that are currently online.

Parameters

None.

Example: https://api.worldwide-combos.com/online.

Response fields

Each response contains a warning field and an error field. If the error field is an empty string, then the online_users_count field is available as well and contains an integer, corresponding to the number of online players.

This is what you could get with the query above.

{
 "warning": "",
 "error": "",
 "online_users_count": 160
}

rankings

This is to retrieve Worldwide Combos rankings with some optional filters.

Parameters

NameOptionalDescription
typeyesThe rankings you are interested in. This field should take one of these values: nl, tl, or an integer corresponding to a ruleset. The default value is nl.
startyesThe rank of the best player that should appear in the query. The default value is 1. In case of ties around the first ranks the players that are chosen to be at those ranks will be chosen arbitrarily.
countyesThe number of players that should appear in the query. The default value is 0, which means that all players until the end appear in the ranking. In case of ties around the last ranks the players that are chosen to be at those ranks will be chosen arbitrarily.

Example: https://api.worldwide-combos.com/rankings?type=sprint&top10=1&start=6&count=5.

Response fields

Each response contains a warning field and an error field. If the error attribute is an empty string, then another field is available as well: the rankings field, which is an array where each element represents one player in the queried rankings, described by the following fields.

NameTypeDescription
rankstringThe rank of the player.
usernamestringThe username of the player.
countrystringThe country of the player.
ratingfloaThe rating of the player, in the leaderboard that was queried.

This is what you could get with the query above.

{
 "warning": "",
 "error": "",
 "rankings": [
	{
	  "rank": 6,
	  "username": "Shan",
	  "country": "New Zealand",
	  "score": 256338
	},
	{
	  "rank": 7,
	  "username": "OnePunMan",
	  "country": "Australia",
	  "score": 257938
	},
	{
	  "rank": 8,
	  "username": "Glasses",
	  "country": "Unknown",
	  "score": 279201
	},
	{
	  "rank": 9,
	  "username": "qmk",
	  "country": "United States",
	  "score": 280992
	},
	{
	  "rank": 10,
	  "username": "Hua",
	  "country": "Taiwan",
	  "score": 288465
	}
 ]
}

Worldwide Combos 5.5.3 - Noël Nadal - logo by Legitimate Ted
Privacy policy - Terms and Conditions - Donate - Submit feedback