Skip to content
This repository was archived by the owner on Apr 7, 2025. It is now read-only.
Matvey edited this page May 10, 2024 · 3 revisions

Downloading levels

By using a dlLevel() function, the entire level can be downloaded and converted into JSON afterwards.

Parameters

id - the level ID.

Example

const gd = require("gj-boomlings-api");
gd.dlLevel(77681476).then(console.log);

Response

Returns a level object.

{
  "id": 77681476,
  "name": "ATOMIC CANNON",
  "description": "After all this time, I have never released a solo. That changes today after EIGHT YEARS. Good luck, you'll need it! Verified by Zeronium.",
  "levelVersion": 2,
  "playerID": 13500423,
  "difficulty": "Extreme Demon",
  "stars": 10,
  "downloads": 89782,
  "likes": 3172,
  "disliked": false,
  "length": "Long",
  "password": "1",
  "demon": true,
  "featured": true,
  "epic": false,
  "objects": 65396,
  "uploaded": "2 years",
  "updated": "2 months",
  "starsRequested": 0,
  "gameVersion": "2.2",
  "ldm": false,
  "copiedFrom": 77681476,
  "large": false,
  "twoPlayer": false,
  "coins": 0,
  "verifiedCoins": false,
  "song": {
    "name": "{dj-N} Intercept 2",
    "id": 177772,
    "artist": "dj-Nate",
    "artistId": 35,
    "fileSize": "1.84 MB",
    "link": "http://audio.ngfiles.com/177000/177772_intercept2.mp3"
  }
}

Daily/Weekly levels

There are getDailyLevel() and getWeeklyDemon() functions to get the daily/weekly level. Basically it's dlLevel() function, but it's set up to daily/weekly levels.

Parameters

No parameters!

Example

// This is an example of a getDailyLevel() function, but getWeeklyDemon() function works the exact same since they both don't have any parameters.
const gd = require("gj-boomlings-api");
gd.getDailyLevel().then(console.log);

Response

no response example, because daily levels are always different

Gauntlets

There is a getGauntlets() function to get all of the gauntlets.

Parameters

No parameters!

Example

const gd = require("gj-boomlings-api");
gd.getGauntlets().then(console.log);

Response

Returns an array of gauntlet objects.

[
  {
    "name": "Fire Gauntlet",
    "levels": [
      27732941,
      28200611,
      27483789,
      28225110,
      27448202
    ]
  },
  {
    "name": "Ice Gauntlet",
    "levels": [
      20635816,
      28151870,
      25969464,
      24302376,
      27399722
    ]
  },
  {
    "name": "Poison Gauntlet",
    "levels": [
      28179535,
      29094196,
      29071134,
      26317634,
      12107595
    ]
  },
  {
    "name": "Shadow Gauntlet",
    "levels": [
      26949498,
      26095850,
      27973097,
      27694897,
      26070995
    ]
  },
  {
    "name": "Lava Gauntlet",
    "levels": [
      18533341,
      28794068,
      28127292,
      4243988,
      28677296
    ]
  },
  {
    "name": "Bonus Gauntlet",
    "levels": [
      28255647,
      27929950,
      16437345,
      28270854,
      29394058
    ]
  },
  {
    "name": "Chaos Gauntlet",
    "levels": [
      25886024,
      4259126,
      26897899,
      7485599,
      19862531
    ]
  },
  {
    "name": "Demon Gauntlet",
    "levels": [
      18025697,
      23189196,
      27786218,
      27728679,
      25706351
    ]
  },
  {
    "name": "Time Gauntlet",
    "levels": [
      40638411,
      32614529,
      31037168,
      40937291,
      35165900
    ]
  },
  {
    "name": "Crystal Gauntlet",
    "levels": [
      37188385,
      35280911,
      37187779,
      36301959,
      36792656
    ]
  },
  {
    "name": "Magic Gauntlet",
    "levels": [
      37269362,
      29416734,
      36997718,
      39853981,
      39853458
    ]
  },
  {
    "name": "Spike Gauntlet",
    "levels": [
      27873500,
      34194741,
      34851342,
      36500807,
      39749578
    ]
  },
  {
    "name": "Monster Gauntlet",
    "levels": [
      43908596,
      41736289,
      42843431,
      44063088,
      44131636
    ]
  },
  {
    "name": "Doom Gauntlet",
    "levels": [
      38427291,
      38514054,
      36966088,
      38398923,
      36745142
    ]
  },
  {
    "name": "Death Gauntlet",
    "levels": [
      44121158,
      43923301,
      43537990,
      33244195,
      35418014
    ]
  },
  {
    "name": "Water Gauntlet",
    "levels": [
      57871639,
      82135935,
      81764520,
      80044470,
      92971865
    ]
  },
  {
    "name": "Portal Gauntlet",
    "levels": [
      75101593,
      62995779,
      93878047,
      71496773,
      58964029
    ]
  },
  {
    "name": "Strange Gauntlet",
    "levels": [
      68265721,
      41092171,
      99230232,
      96419926,
      78878411
    ]
  },
  {
    "name": "Fantasy Gauntlet",
    "levels": [
      92555035,
      94887416,
      85219434,
      89465157,
      82357008
    ]
  },
  {
    "name": "Castle Gauntlet",
    "levels": [
      80218929,
      95436164,
      64302902,
      65044525,
      66960655
    ]
  },
  {
    "name": "World Gauntlet",
    "levels": [
      83313115,
      83325036,
      83302544,
      83325083,
      81451870
    ]
  },
  {
    "name": "Galaxy Gauntlet",
    "levels": [
      83294687,
      83323867,
      83320529,
      83315343,
      83324930
    ]
  },
  {
    "name": "Universe Gauntlet",
    "levels": [
      83323273,
      83025300,
      83296274,
      83256789,
      83323659
    ]
  },
  {
    "name": "Discord Gauntlet",
    "levels": [
      89521875,
      90475659,
      90117883,
      88266256,
      88775556
    ]
  },
  {
    "name": "Split Gauntlet",
    "levels": [
      90459731,
      90475597,
      90471222,
      90251922,
      90475473
    ]
  }
]

Getting the level by its ID

Yeah, sounds pretty weird, since we already can download levels, but... let me explain.

Levels' search results are basically the same thing as downloading them, except, they don't provide the level description, password, update date, upload date, the LDM checkbox and the actual level string. It can be really useful in some sort of bots to get the basic info really quick.

You can use the getLevelByID() function to do this. Actually it just searches for the levels with the provided ID.

Parameters

id - the level ID.

Example

const gd = require("gj-boomlings-api");
gd.getLevelByID(77681476).then(console.log);

Response

Returns the level object.

{
  "id": 77681476,
  "name": "ATOMIC CANNON",
  "levelVersion": 2,
  "playerID": 13500423,
  "difficulty": "Extreme Demon",
  "stars": 10,
  "downloads": 89785,
  "likes": 3172,
  "disliked": false,
  "length": "Long",
  "demon": true,
  "featured": true,
  "epic": false,
  "objects": 0,
  "starsRequested": 0,
  "gameVersion": "2.2",
  "copiedFrom": 77681476,
  "large": false,
  "twoPlayer": false,
  "coins": 0,
  "verifiedCoins": false,
  "creator": "LIEB",
  "song": {
    "name": "{dj-N} Intercept 2",
    "id": 177772,
    "artist": "dj-Nate",
    "artistId": 35,
    "fileSize": "1.84 MB",
    "link": "http://audio.ngfiles.com/177000/177772_intercept2.mp3"
  }
}

NOTE: Since dlLevel() actually downloads the level string, I used it to make a pretty accurate object counter. But it doesn't work for search results, so they just cap at 65535 objects, for some reason.

Map packs

There's a getMapPacks() function to get the info about map packs.

Parameters

page (optional) - the search page. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.getMapPacks(2).then(console.log)

Response

Returns an array of map pack objects.

[
  {
    "name": "Ruby Pack",
    "id": 55,
    "levels": [
      1446958,
      1063115,
      1734354
    ],
    "stars": 4,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FF3232",
    "barColor": "#FF3232"
  },
  {
    "name": "Electro Pack",
    "id": 70,
    "levels": [
      5131543,
      8157377,
      8571598
    ],
    "stars": 4,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#AFFF19",
    "barColor": "#AFFF19"
  },
  {
    "name": "Laser Pack",
    "id": 71,
    "levels": [
      12178580,
      11357573,
      11591917
    ],
    "stars": 4,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FF32C8",
    "barColor": "#FF32C8"
  },
  {
    "name": "Glow Pack",
    "id": 72,
    "levels": [
      4449079,
      6979485,
      10110092
    ],
    "stars": 4,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#C832FF",
    "barColor": "#C832FF"
  },
  {
    "name": "Spirit Pack",
    "id": 73,
    "levels": [
      13766381,
      13242284,
      13963465
    ],
    "stars": 4,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#00FFFF",
    "barColor": "#00FFFF"
  },
  {
    "name": "Hard Pack",
    "id": 5,
    "levels": [
      217631,
      3785,
      281148
    ],
    "stars": 5,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#00C8FF",
    "barColor": "#00C8FF"
  },
  {
    "name": "Morph Pack",
    "id": 33,
    "levels": [
      364445,
      411459,
      509393
    ],
    "stars": 5,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FFC800",
    "barColor": "#FFC800"
  },
  {
    "name": "Phoenix Pack",
    "id": 37,
    "levels": [
      674454,
      750434,
      835854
    ],
    "stars": 5,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FF00C8",
    "barColor": "#FF00C8"
  },
  {
    "name": "Power Pack",
    "id": 38,
    "levels": [
      809579,
      741941,
      577710
    ],
    "stars": 5,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FFFF00",
    "barColor": "#FFFF00"
  },
  {
    "name": "Shiny Pack",
    "id": 56,
    "levels": [
      980341,
      1541962,
      1160937
    ],
    "stars": 5,
    "coins": 1,
    "difficulty": "Hard",
    "textColor": "#FFFFAF",
    "barColor": "#FFFFAF"
  }
]

Level comments

You can use a getComments() function to get the level comments.

Parameters

level - the level ID to get the comments from.

page (optional) - the comments page. Defaults to 1.

mode (optional) - the searching mode. 0 for recent, 1 for most liked. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.getComments(42584142).then(console.log);

Response

Returns an array of comment objects.

[
  {
    "content": "All demons default to hard when first rated, they get the real rating from votes later :)",
    "playerID": 16,
    "likes": 94633,
    "disliked": false,
    "percent": 0,
    "id": 12967791,
    "age": "6 years",
    "username": "RobTop",
    "iconID": 4,
    "c1": "#640096",
    "c2": "#00FF7D",
    "iconType": "cube",
    "glow": false,
    "accountID": 71,
    "mod": "elder",
    "color": "#4BFF4B"
  },
  {
    "content": "IT IS FINALLY OVER!!!!!!!!!!!!!! THIS IS IT!!! THANK YOU ALL!!!!",
    "playerID": 4214375,
    "likes": 82499,
    "disliked": false,
    "percent": 0,
    "id": 12958654,
    "age": "6 years",
    "username": "Knobbelboy",
    "iconID": 37,
    "c1": "#FF7D00",
    "c2": "#FFB900",
    "iconType": "cube",
    "glow": false,
    "accountID": 136788
  },
  {
    "content": "1% :O :O :O :O",
    "playerID": 16,
    "likes": 41455,
    "disliked": false,
    "percent": 0,
    "id": 16183012,
    "age": "6 years",
    "username": "RobTop",
    "iconID": 4,
    "c1": "#640096",
    "c2": "#00FF7D",
    "iconType": "cube",
    "glow": false,
    "accountID": 71,
    "mod": "elder",
    "color": "#4BFF4B"
  },
  {
    "content": "Zobros: Easy Insane 9",
    "playerID": 1995959,
    "likes": 36313,
    "disliked": false,
    "percent": 0,
    "id": 12968377,
    "age": "6 years",
    "username": "shaggy23",
    "iconID": 51,
    "c1": "#640096",
    "c2": "#FFB900",
    "iconType": "cube",
    "glow": true,
    "accountID": 2888
  },
  {
    "content": "pro tip : don't play bloodlust on phone",
    "playerID": 15630652,
    "likes": 36078,
    "disliked": false,
    "percent": 1,
    "id": 12960792,
    "age": "6 years",
    "username": "IInfinityy",
    "iconID": 22,
    "c1": "#7DFFAF",
    "c2": "#00FFFF",
    "iconType": "ship",
    "glow": false,
    "accountID": 4522823
  },
  {
    "content": "Pass is 121296, now like this comment so others can see",
    "playerID": 78434904,
    "likes": 20820,
    "disliked": false,
    "percent": 0,
    "id": 13250862,
    "age": "6 years",
    "username": "brebnt",
    "iconID": 9,
    "c1": "#7DFF00",
    "c2": "#FFFFFF",
    "iconType": "ball",
    "glow": false,
    "accountID": 8632807
  },
  {
    "content": "PRESS F TO RESPECT THE H*CK OUT OF KNOBBELBOY",
    "playerID": 2614903,
    "likes": 17902,
    "disliked": false,
    "percent": 0,
    "id": 12970170,
    "age": "6 years",
    "username": "Juniper",
    "iconID": 98,
    "c1": "#7DFFAF",
    "c2": "#FFFFFF",
    "iconType": "cube",
    "glow": true,
    "accountID": 13364,
    "mod": "mod",
    "color": "#C8FFC8"
  },
  {
    "content": "Guess now Knobbelboy evolved to Knobbelman",
    "playerID": 19203596,
    "likes": 16714,
    "disliked": false,
    "percent": 0,
    "id": 12962171,
    "age": "6 years",
    "username": "SerSerpent",
    "iconID": 74,
    "c1": "#00C8FF",
    "c2": "#FFFFFF",
    "iconType": "cube",
    "glow": true,
    "accountID": 5586751
  },
  {
    "content": "Like if you have 0% or 1% or 2%",
    "playerID": 19888005,
    "likes": 11117,
    "disliked": false,
    "percent": 0,
    "id": 13006948,
    "age": "6 years",
    "username": "DontCareGD",
    "iconID": 45,
    "c1": "#FFFFFF",
    "c2": "#000000",
    "iconType": "cube",
    "glow": false,
    "accountID": 5918286
  },
  {
    "content": "aoc",
    "playerID": 14251090,
    "likes": 7659,
    "disliked": false,
    "percent": 100,
    "id": 14252314,
    "age": "6 years",
    "username": "lSunix",
    "iconID": 459,
    "c1": "#FFFFFF",
    "c2": "#FFFFFF",
    "iconType": "cube",
    "glow": false,
    "accountID": 3961368
  }
]

Searching levels

The searchLevels() function can be used to search levels by a specified query.

Parameters

query - the searching query.

page (optional) - the search page. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.searchLevels(42584142).then(console.log);

Response

Returns an array of level objects.

[
  {
    "id": 26681070,
    "name": "Sonic Wave",
    "levelVersion": 14,
    "playerID": 14251090,
    "difficulty": "Extreme Demon",
    "stars": 10,
    "downloads": 24458947,
    "likes": 809186,
    "disliked": false,
    "length": "XL",
    "demon": true,
    "featured": true,
    "epic": false,
    "objects": 23157,
    "starsRequested": 10,
    "gameVersion": "2.2",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "lSunix",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 28250365,
    "name": "Sonic wave noclip",
    "levelVersion": 10,
    "playerID": 10037575,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 2815971,
    "likes": 121783,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 65535,
    "starsRequested": 1,
    "gameVersion": "2.1",
    "copiedFrom": 8585365,
    "large": true,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "Unary",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 13064746,
    "name": "Sonic Wave",
    "levelVersion": 1,
    "playerID": 7540019,
    "difficulty": "Insane",
    "stars": 0,
    "downloads": 2273005,
    "likes": 90339,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": true,
    "epic": false,
    "objects": 0,
    "starsRequested": 10,
    "gameVersion": "2.0",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "Cyrillic",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 69685815,
    "name": "Sonic Wave Infinity",
    "levelVersion": 1,
    "playerID": 128487241,
    "difficulty": "Extreme Demon",
    "stars": 10,
    "downloads": 2102636,
    "likes": 80332,
    "disliked": false,
    "length": "XL",
    "demon": true,
    "featured": true,
    "epic": false,
    "objects": 0,
    "starsRequested": 10,
    "gameVersion": "2.2",
    "copiedFrom": 69685815,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "APTeamOfficial",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 8777348,
    "name": "Sonic Wave auto",
    "levelVersion": 6,
    "playerID": 3160981,
    "difficulty": "Hard",
    "stars": 0,
    "downloads": 1778068,
    "likes": 64465,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 0,
    "starsRequested": 0,
    "gameVersion": "1.9",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "therealniloc",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 8933726,
    "name": "Sonic Wave easy",
    "levelVersion": 2,
    "playerID": 4978204,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 1653340,
    "likes": 52449,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 0,
    "starsRequested": 7,
    "gameVersion": "2.0",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "DerGamerTyp",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 9032544,
    "name": "Sonic Wave Auto",
    "levelVersion": 8,
    "playerID": 2398162,
    "difficulty": "Hard",
    "stars": 0,
    "downloads": 946137,
    "likes": 48683,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 21308,
    "starsRequested": 1,
    "gameVersion": "2.2",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": true,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "BlueTheSquid",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 22058345,
    "name": "Sonic Wave Deluxe",
    "levelVersion": 3,
    "playerID": 10503308,
    "difficulty": "Hard",
    "stars": 0,
    "downloads": 845319,
    "likes": 47304,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 0,
    "starsRequested": 10,
    "gameVersion": "2.0",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "toshey",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 68688849,
    "name": "Sonic Wave Rebirth",
    "levelVersion": 2,
    "playerID": 4170784,
    "difficulty": "Extreme Demon",
    "stars": 10,
    "downloads": 1653781,
    "likes": 43839,
    "disliked": false,
    "length": "XL",
    "demon": true,
    "featured": true,
    "epic": true,
    "objects": 52486,
    "starsRequested": 10,
    "gameVersion": "2.2",
    "copiedFrom": 8585365,
    "large": true,
    "twoPlayer": false,
    "coins": 3,
    "verifiedCoins": true,
    "creator": "Serponge",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  },
  {
    "id": 37562566,
    "name": "Sonic Wave auto",
    "levelVersion": 1,
    "playerID": 37288921,
    "difficulty": "Normal",
    "stars": 0,
    "downloads": 531998,
    "likes": 29391,
    "disliked": false,
    "length": "XL",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 24646,
    "starsRequested": 1,
    "gameVersion": "2.1",
    "copiedFrom": 8585365,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "SuperVegasXXX",
    "song": {
      "name": "F-777 - Sonic Blaster",
      "id": 574484,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "6.95 MB",
      "link": "http://audio.ngfiles.com/574000/574484_F-777---Sonic-Blaster.mp3"
    }
  }
]

Getting someone's levels

Based on searching levels, you can get someone's levels. To do this, you can use the getUserLevels() function.

Parameters

str - the player's username or player ID. It's important for the player to be registered. (i think i'll fix it later for non-registered accounts)

page (optional) - the searching page. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.getUserLevels("shikoshib").then(console.log);

Response

Returns an array of level objects.

[
  {
    "id": 95540029,
    "name": "hi there",
    "levelVersion": 2,
    "playerID": 147957957,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 347,
    "likes": 36,
    "disliked": false,
    "length": "Long",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 39509,
    "starsRequested": 10,
    "gameVersion": "2.1",
    "copiedFrom": 0,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "~hi there~",
      "id": 1203501,
      "artist": "shikoshib",
      "artistId": 10001037,
      "fileSize": "3.35 MB",
      "link": "https://audio.ngfiles.com/1203000/1203501_hi-there.mp3?f1679827176"
    }
  },
  {
    "id": 89028539,
    "name": "untitled level",
    "levelVersion": 4,
    "playerID": 147957957,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 718,
    "likes": 86,
    "disliked": false,
    "length": "Long",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 12174,
    "starsRequested": 4,
    "gameVersion": "2.1",
    "copiedFrom": 0,
    "large": false,
    "twoPlayer": false,
    "coins": 2,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "Within The Sadness (1f1n1ty RMX)",
      "id": 669275,
      "artist": "1f1n1ty",
      "artistId": 2741,
      "fileSize": "6.33 MB",
      "link": "http://audio.ngfiles.com/669000/669275_Within-The-Sadness-1f1n1ty.mp3"
    }
  },
  {
    "id": 81304994,
    "name": "paketik",
    "levelVersion": 5,
    "playerID": 147957957,
    "difficulty": "Hard",
    "stars": 0,
    "downloads": 291,
    "likes": 26,
    "disliked": false,
    "length": "Medium",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 86,
    "starsRequested": 0,
    "gameVersion": "2.1",
    "copiedFrom": 81304994,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "Back 2 the Retro",
      "id": 1099126,
      "artist": "shikoshib",
      "artistId": 10001037,
      "fileSize": "9.21 MB",
      "link": "https://audio.ngfiles.com/1099000/1099126_Back-2-the-Retro.mp3?f1640426505"
    }
  },
  {
    "id": 80679252,
    "name": "Windows Animations",
    "levelVersion": 1,
    "playerID": 147957957,
    "difficulty": "Normal",
    "stars": 0,
    "downloads": 249,
    "likes": 29,
    "disliked": false,
    "length": "Medium",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 65535,
    "starsRequested": 1,
    "gameVersion": "2.1",
    "copiedFrom": 0,
    "large": true,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "The Key to the Insanity",
      "id": 1126264,
      "artist": "shikoshib",
      "artistId": 10001037,
      "fileSize": "7 MB",
      "link": "https://audio.ngfiles.com/1126000/1126264_The-Key-to-the-Insanity.mp3?f1650579048"
    }
  },
  {
    "id": 80248211,
    "name": "Lost or Not 2",
    "levelVersion": 1,
    "playerID": 147957957,
    "difficulty": "Insane",
    "stars": 0,
    "downloads": 186,
    "likes": 8,
    "disliked": false,
    "length": "Long",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 16086,
    "starsRequested": 0,
    "gameVersion": "2.1",
    "copiedFrom": 80248211,
    "large": false,
    "twoPlayer": false,
    "coins": 3,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "Not Lost",
      "id": 1107430,
      "artist": "shikoshib",
      "artistId": 10001037,
      "fileSize": "8.5 MB",
      "link": "https://audio.ngfiles.com/1107000/1107430_Not-Lost.mp3?f1643365615"
    }
  },
  {
    "id": 79650761,
    "name": "Lost or Not",
    "levelVersion": 1,
    "playerID": 147957957,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 249,
    "likes": 21,
    "disliked": false,
    "length": "Long",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 10537,
    "starsRequested": 0,
    "gameVersion": "2.2",
    "copiedFrom": 79650761,
    "large": false,
    "twoPlayer": false,
    "coins": 3,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "Not Lost",
      "id": 1107430,
      "artist": "shikoshib",
      "artistId": 10001037,
      "fileSize": "8.5 MB",
      "link": "https://audio.ngfiles.com/1107000/1107430_Not-Lost.mp3?f1643365615"
    }
  },
  {
    "id": 76643578,
    "name": "Ok Just Get It",
    "levelVersion": 1,
    "playerID": 147957957,
    "difficulty": "Harder",
    "stars": 0,
    "downloads": 166,
    "likes": 14,
    "disliked": false,
    "length": "Long",
    "demon": false,
    "featured": false,
    "epic": false,
    "objects": 4382,
    "starsRequested": 0,
    "gameVersion": "2.1",
    "copiedFrom": 76643578,
    "large": false,
    "twoPlayer": false,
    "coins": 0,
    "verifiedCoins": false,
    "creator": "shikoshib",
    "song": {
      "name": "F-777 - Medusa",
      "id": 798747,
      "artist": "F-777",
      "artistId": 286,
      "fileSize": "7.39 MB",
      "link": "https://audio.ngfiles.com/798000/798747_F-777---Medusa.mp3?f1522612006"
    }
  }
]

Getting top lists

The getTopLists() method can be used to get the list of the most liked lists of levels.

Parameters

page (optional) - the searching page. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.getTopLists().then(console.log);

Response

Returns an array of list objects.

[
  {
    "id": 193463,
    "name": "Retro Arcade Games",
    "description": "Hey gamers! Here is a list with lots of fun videogame themed level or inspired in other videogames or those who feels like retro levels/games. Made for those who enjoy arcade games, platformers, retro, etc! Suggest more levels in the comment section of this list if you find a cool one!",
    "difficulty": "Easy Demon",
    "username": "16lord",
    "playerID": 83020987,
    "accountID": 9099846,
    "downloads": 125627,
    "likes": 1538,
    "diamonds": 80,
    "disliked": false,
    "levels": [
      86041694,
      63029657,
      6508283,
      67661363,
      82115090,
      88444739,
      62089130,
      97978413,
      97866974,
      91791295,
      44896822,
      100138257,
      46993109,
      54377166,
      66308464,
      4604249,
      98972163,
      12107595,
      82170589,
      35789401,
      98766903,
      100157619,
      5337984,
      79445419,
      13813196,
      74928408,
      87115571,
      60621991,
      98100704,
      44842833,
      97910997,
      72128413,
      98423083,
      90475473,
      94229906,
      79958107,
      60605814,
      79691289,
      73249160,
      73278665,
      63521602,
      75387502,
      97906220,
      58270823,
      96705689,
      95436030,
      100032992,
      99443178,
      101868760,
      15427055,
      102814497,
      43945511,
      27541081,
      97001775,
      99927952
    ],
    "required": 24,
    "uploadedUnix": 1707249544
  },
  {
    "id": 319863,
    "name": "How",
    "description": "How????",
    "difficulty": "Insane",
    "username": "ML500",
    "playerID": 1943440,
    "accountID": 2102,
    "downloads": 64340,
    "likes": 859,
    "diamonds": 40,
    "disliked": false,
    "levels": [
      63395980,
      1497528,
      65241297,
      75290963,
      82573736,
      98543032,
      50040411,
      82339836,
      60883539,
      104275383,
      102343047,
      71397494
    ],
    "required": 7,
    "uploadedUnix": 1713755850
  },
  {
    "id": 324412,
    "name": "Demon Park",
    "description": "Just some bros hanging out. Owned by M2coL.",
    "difficulty": "Hard Demon",
    "username": "connot",
    "playerID": 14175109,
    "accountID": 4682863,
    "downloads": 61957,
    "likes": 614,
    "diamonds": 65,
    "disliked": false,
    "levels": [
      10109,
      80165559,
      34085027,
      103350344,
      11607707,
      86589947,
      97001775,
      89472209,
      61079355,
      83825373
    ],
    "required": 5,
    "uploadedUnix": 1714080662
  },
  {
    "id": 313309,
    "name": "We Didnt Start The Fire",
    "description": "it was always crashing since the world's been dashing",
    "difficulty": "Normal",
    "username": "Colon",
    "playerID": 4136576,
    "accountID": 106255,
    "downloads": 339775,
    "likes": 6874,
    "diamonds": 65,
    "disliked": false,
    "levels": [
      11940,
      88737,
      215705,
      714673,
      750434,
      809579,
      819956,
      2915652,
      3010126,
      3140440,
      3382569,
      4454123,
      6508283,
      8939774,
      12057578,
      27483789,
      27511695,
      27732941,
      27961648,
      28200611,
      28255647,
      41220983,
      43908596,
      60679881,
      64302902,
      64379252,
      65227464,
      70680001,
      77292103,
      89886591
    ],
    "required": 20,
    "uploadedUnix": 1713414883
  },
  {
    "id": 99335,
    "name": "28 de Julio",
    "description": "Made in Peru",
    "difficulty": "Harder",
    "username": "heda",
    "playerID": 7178197,
    "accountID": 906671,
    "downloads": 20593,
    "likes": 490,
    "diamonds": 45,
    "disliked": false,
    "levels": [
      58107944,
      70465674,
      61511307,
      61260879,
      75585416,
      48587134,
      73809802,
      76972932,
      87029633,
      82028872,
      93214939,
      67596678,
      38411820,
      83323273,
      93269697
    ],
    "required": 8,
    "uploadedUnix": 1704149875
  },
  {
    "id": 306828,
    "name": "Feline Frenzy",
    "description": "A compilation of cat themed levels for my fellow cat lovers out there! Comment if I missed any good ones :3",
    "difficulty": "Harder",
    "username": "wMeowlissa",
    "playerID": 5120428,
    "accountID": 238479,
    "downloads": 9429,
    "likes": 327,
    "diamonds": 40,
    "disliked": false,
    "levels": [
      41651369,
      50698627,
      88615520,
      51250455,
      67999789,
      100223720,
      101612404,
      99395643,
      86260534,
      46318295,
      21395297,
      21999337,
      87869107,
      73218818,
      81860983,
      97736834,
      101461709,
      1664135,
      59331033
    ],
    "required": 9,
    "uploadedUnix": 1713038499
  },
  {
    "id": 318969,
    "name": "GD Grand Prix",
    "description": "on your marks...",
    "difficulty": "Normal",
    "username": "Whirl",
    "playerID": 11411324,
    "accountID": 2358957,
    "downloads": 25166,
    "likes": 451,
    "diamonds": 45,
    "disliked": false,
    "levels": [
      81257107,
      82115090,
      97866974,
      88444739,
      60258035,
      60880958,
      97780059
    ],
    "required": 7,
    "uploadedUnix": 1713720559
  },
  {
    "id": 312844,
    "name": "Fav Platformers Ranked",
    "description": "Ranked from best to worst according to how much I personally liked them! Made on 17th April 2024 so no levels after this date are on this list :)",
    "difficulty": "N/A",
    "username": "Incidius",
    "playerID": 11742683,
    "accountID": 5890735,
    "downloads": 217777,
    "likes": 2934,
    "diamonds": 80,
    "disliked": false,
    "levels": [
      98439428,
      100424840,
      99671367,
      100995750,
      99516517,
      101102438,
      99721341,
      104043964,
      98552638,
      101881636,
      100486532,
      99855394,
      103821886,
      98505331,
      101926022,
      98322118,
      102571230,
      103065307,
      103430142,
      98819763,
      100457692,
      98893353,
      102814497,
      101860446,
      100713173,
      101131113,
      102649360,
      99166194,
      99110853,
      98275850,
      100048911,
      103723111,
      99986024,
      97812307,
      101850302,
      98747150,
      101624652,
      97776995,
      99058033,
      101087105,
      97793375,
      98163412,
      102546298,
      100791583,
      97660104,
      99978783,
      98545452,
      103736188,
      102766357,
      98052971
    ],
    "required": 16,
    "uploadedUnix": 1713385012
  },
  {
    "id": 22790,
    "name": "BFDI",
    "description": "This is so dumb, ALSO IM NOT GONNA FINISH THIS LOL",
    "difficulty": "Insane",
    "username": "Bokymation",
    "playerID": 160839984,
    "accountID": 16453432,
    "downloads": 15118,
    "likes": 535,
    "diamonds": 60,
    "disliked": false,
    "levels": [
      12013913,
      90153247,
      72138480,
      5854379,
      80738901,
      15793948,
      45124246,
      30165972,
      95385222,
      39623007,
      38655691,
      59313611,
      55446972,
      94373950,
      77522713,
      46096253,
      78589603,
      40945673,
      20261830,
      79192575,
      70563932,
      10285570,
      71512849,
      5477912
    ],
    "required": 14,
    "uploadedUnix": 1703127690
  },
  {
    "id": 171449,
    "name": "Terraria enthusiasts",
    "description": "Terraria God",
    "difficulty": "Insane",
    "username": "ElMatoSWAG",
    "playerID": 7388711,
    "accountID": 1222145,
    "downloads": 75782,
    "likes": 965,
    "diamonds": 45,
    "disliked": false,
    "levels": [
      100214123,
      45192741,
      99246000,
      58332937,
      90251922,
      98716888,
      69230086,
      79910473,
      100698142,
      97882006,
      98707083,
      81548163
    ],
    "required": 5,
    "uploadedUnix": 1706380389
  }
]

Searching lists

The searchLists() function can be used to search lists by a specified query.

Parameters

query - the searching query.

page (optional) - the search page. Defaults to 1.

Example

const gd = require("gj-boomlings-api");
gd.searchLists("geometry dash", 2).then(console.log);

Response

Returns an array of list objects.

[
  {
    "id": 6183,
    "name": "Geometry Dash World",
    "description": "Collection of full-fledged levels from GD World.",
    "difficulty": "Hard",
    "username": "JefferyGMD",
    "playerID": 160708168,
    "accountID": 21078431,
    "downloads": 5552,
    "likes": 90,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      27885526,
      29094196,
      29195797,
      28151682,
      28127292,
      87137700,
      91929602,
      27636745,
      87297448,
      100105508
    ],
    "required": 0,
    "uploadedUnix": 1703057474
  },
  {
    "id": 141123,
    "name": "Geometry Dash Blizzard",
    "description": "Geometry Dash Blizzard Main Levels (some levels was using copyright music so i changed it)",
    "difficulty": "Harder",
    "username": "GenaMorphosis",
    "playerID": 85056423,
    "accountID": 10026833,
    "downloads": 6725,
    "likes": 81,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      99170983,
      99168289,
      99167447
    ],
    "required": 0,
    "uploadedUnix": 1705270631
  },
  {
    "id": 128856,
    "name": "geometry dash full ver ",
    "description": "these are the full versions of robtop levels but updated to 2.2. sorry couldnt find the secret hollow and the cellar full ver :(",
    "difficulty": "Insane",
    "username": "creatorbasic6",
    "playerID": 224075695,
    "accountID": 26997568,
    "downloads": 4711,
    "likes": 80,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      12260817,
      12561472,
      4122470,
      14276016,
      13161728,
      13295025,
      38751859,
      13773624,
      14703083,
      15478726,
      19575186,
      31420789,
      41298282,
      43837113,
      62945274,
      63271983,
      54986155,
      59119758,
      47959620,
      51314660,
      46122741,
      99775670,
      30597222,
      54919774,
      55939566,
      51082036,
      59306832,
      62952239,
      62184706,
      64374570,
      59375723,
      61193287,
      61632819,
      62482674,
      63372746,
      47085842,
      55552609,
      45659659,
      52814399,
      98484220,
      98478395
    ],
    "required": 0,
    "uploadedUnix": 1704901755
  },
  {
    "id": 17336,
    "name": "Geometry Dash Aviation",
    "description": "This series has been in the works for 1-2 years... Hope you enjoy! The levels are not layouts, they're 1.0 styled.",
    "difficulty": "Medium Demon",
    "username": "Kwetz",
    "playerID": 139507516,
    "accountID": 14150837,
    "downloads": 3455,
    "likes": 59,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      72976946,
      69577705,
      79261827,
      79488406,
      79736907,
      79783722,
      79955033,
      79989195,
      80032700,
      80037098,
      80092486,
      80484207,
      80648532,
      80932149,
      86072341,
      86916391,
      87425602,
      87792353,
      88434462,
      88560376,
      89219213,
      89858713,
      90940030,
      90960130,
      90977876,
      91294935,
      91500835,
      91533244,
      91792883,
      91859215,
      91942261,
      92065083,
      92150318,
      92503529,
      92545387,
      98948385,
      99427125,
      100276003,
      100790665,
      101177088,
      102022373
    ],
    "required": 0,
    "uploadedUnix": 1703104268
  },
  {
    "id": 32141,
    "name": "Geometry Dash World",
    "description": "Every level from Geometry Dash World, directly ripped from the game files!",
    "difficulty": "Extreme Demon",
    "username": "gamerpig7459",
    "playerID": 205483655,
    "accountID": 26023941,
    "downloads": 2808,
    "likes": 48,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      77241646,
      77241647,
      77241651,
      77241652,
      77241653,
      77242474,
      77242475,
      77242477,
      77242480,
      77242482
    ],
    "required": 0,
    "uploadedUnix": 1703193859
  },
  {
    "id": 15556,
    "name": "geometry dash expanded",
    "description": "real fanmade spin off",
    "difficulty": "Extreme Demon",
    "username": "Boboaguillon",
    "playerID": 138084637,
    "accountID": 14035490,
    "downloads": 3485,
    "likes": 45,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      104568755,
      77236587,
      100891052,
      77236588,
      77236592,
      104337224,
      101808763,
      77236593,
      9008338,
      77237540,
      96254047,
      96254199,
      77237542,
      91016367,
      77237545,
      103091975,
      91016368,
      91016370,
      96080972,
      98315458,
      77237547,
      96258206,
      101330933,
      77237548,
      104637521,
      96381061,
      77238470,
      103214702,
      89332040,
      103389131,
      77238474,
      77238477,
      77238483,
      77238488,
      104709739,
      77239587,
      104082601,
      77239588,
      77239595,
      89996006,
      77239599,
      4284013,
      91676747,
      77240636,
      77240637,
      77240642,
      77239604,
      77240630,
      27885526,
      77241647,
      77241651,
      77241652,
      77241653,
      77242474,
      77242475,
      77242477,
      77242480,
      77242482,
      95238029,
      95238038,
      95238070,
      95238125,
      95239678,
      77240633,
      77243245,
      34452078,
      94339285,
      92528982,
      86693053,
      87997751,
      87225449,
      89388501,
      88710481,
      91147888,
      91441076,
      92637146,
      93262168,
      93974122,
      77243256,
      77243257,
      77243258,
      100330894,
      97459478,
      104138684,
      97592530,
      100841803,
      35385799,
      99578610,
      102341401,
      102341601,
      102341639,
      102341648,
      102341654,
      102343042,
      102343047,
      102343052,
      104593403
    ],
    "required": 0,
    "uploadedUnix": 1703098335
  },
  {
    "id": 33548,
    "name": "Geometry Dash Remastered",
    "description": "All the main RobTop levels, now in the 2nd version, in one full list! (This is as of 2.1, until Dash gets a legit V2)",
    "difficulty": "Medium Demon",
    "username": "Japan227",
    "playerID": 169272222,
    "accountID": 23268482,
    "downloads": 4820,
    "likes": 42,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      59767,
      61982,
      65106,
      71485,
      77879,
      79275,
      87960,
      116806,
      278956,
      341613,
      358750,
      369294,
      428765,
      450920,
      839175,
      1698428,
      2899139,
      3013070,
      12926233,
      12174771,
      28672992,
      99539200
    ],
    "required": 0,
    "uploadedUnix": 1703203238
  },
  {
    "id": 89616,
    "name": "geometry dash world full",
    "description": "",
    "difficulty": "Insane",
    "username": "ABDIGDPSE22",
    "playerID": 237539795,
    "accountID": 26501433,
    "downloads": 3437,
    "likes": 41,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      59306832,
      62952239,
      62184706,
      64374570,
      59375723,
      61193287,
      66698621,
      68530791,
      63372746,
      81058483
    ],
    "required": 0,
    "uploadedUnix": 1703949228
  },
  {
    "id": 80019,
    "name": "Geometry Dash Razorleaf",
    "description": "By Eplecena",
    "difficulty": "Normal",
    "username": "ABDIGDPSE22",
    "playerID": 237539795,
    "accountID": 26501433,
    "downloads": 3192,
    "likes": 41,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      92305959,
      92305988,
      92306022
    ],
    "required": 0,
    "uploadedUnix": 1703768285
  },
  {
    "id": 316801,
    "name": "Geometry Dash Reborn",
    "description": "UPDATE 1.1! New Level: Eternity! Welcome to Geometry Dash: Reborn! This is a fan-game that takes the original levels and adds new gameplay and songs! This will be updated and the levels will follow the according style. Enjoy!",
    "difficulty": "Hard",
    "username": "col138",
    "playerID": 148526337,
    "accountID": 14873791,
    "downloads": 440,
    "likes": 32,
    "diamonds": 0,
    "disliked": false,
    "levels": [
      104218578,
      104218587,
      104218596,
      104218601,
      104835588
    ],
    "required": 0,
    "uploadedUnix": 1713627430
  }
]