<sb>Geometry Dash Level Browser API</sb>! <br><br> The
<sb>API</sb> (application programming interface) is how the website is able to get all the neat stuff from the Geometry Dash servers. In the off chance that you actually know what any of this means, this page contains everything you need to know about grabbing information on GD levels/accounts/etc without going through the trouble of using the actual GD API on boomlings.com
<br><br>
Geometry Dash's API isn't meant to be publicly used, and is a <ahref="https://i.imgur.com/PZ2AsZB.png"target="_blank">total nightmare</a> to fetch stuff from. That's why I made this API to send you whatever you need in a nice, clean JSON. You're welcome.<br><br>Everything on the API can be accessed
<sb>without any authorization</sb>, and with little to no required parameters.</p>
</div>
<divclass="main-block";style="margin-top: 20px">
<p>Here are the different things you can use the API for. Click one to skip to it's documentation.</p>
<p>In the event that something goes horribly wrong and the server doesn't like your request (or you tried to search for a level/profile/etc that doesn't exist), the API will return
<sb>"-1"</sb>. It doesn't actually mean anything, I was just referencing the Geometry Dash servers. But yeah, if it responds that just double check the documentation or make sure what you're looking for actually exists.</p>
<p><b>If by any chance you use this API for other projects, credit is greatly appreciated! <smile1></smile1></b></p>
</div>
<divclass="seperator"></div>
</main>
<mainclass="alt">
<divid="level""></div>
<divclass="main-block">
<h1>Levels</h1>
<p>/api/level/levelID</p>
<br>
<p>LevelID should be the ID of a level (whoa)</p>
<p>Using "daily" or "weekly" as the level ID will return the current daily/weekly level (always downloaded)</p>
<p>accountID: An additional ID for registered accounts</p>
<p>rank: The global rank of the player. Returns 0 if banned or star count is too low</p>
<p>stars: Number of stars the player has</p>
<p>diamonds: Number of diamonds</p>
<p>coins: Number of secret coins</p>
<p>userCoins: Number of user coins</p>
<p>demons: Number of completed demons</p>
<p>cp: Number of creator points</p>
<p>friendRequests: If the player has friend requests enabled</p>
<p>messages: If the player has messages enabled. Returns "all", "friends", or "off"</p>
<p>commentHistory: If the player has a visible comment history. Returns "all", "friends", or "off"</p>
<p>moderator: If the player is a moderator. Returns 0 (none), 1 (mod) or 2 (elder)</p>
<p>youtube: The URL of the player's YouTube channel, if linked. Plug it into https://youtube.com/channel/{youtube}</p>
<p>twitter: The URL of the player's Twitter account, if linked. Plug it into https://twitter.com/{twitter}</p>
<p>twitch: The URL of the player's Twitch account, if linked. Plug it into https://twitch.tv/{twitch}</p>
<p>glow: If the player's icon has a glow or not</p>
<p>icon, ship, ball, ufo, wave, robot, spider, col1, col2, deathEffect: The number of the icon/color used for each form. The actual icon needs to be manually constructed. My <ahref="https://gdcolon.com/tools/iconkit"target="_blank">Online Icon Kit</a> could be of assistance.</p>
<p><b>Params that require a number</b> (e.g. ?page=1)</p>
<p>count: The amount of levels to list (default and max is 10)</p>
<p>diff: The number of the difficulty to search for, see <u>difficulty IDs</u> below</p>
<p>demonFilter: If searching for demon levels, what difficulty to search for (1 is easy, 5 is extreme)</p>
<p>page: The page of the search</p>
<p>gauntlet: The number of the gauntlet to view (will return the 5 levels)</p>
<p>length: Only return levels with this length (0-4, 0 is tiny and 4 is XL)</p>
<p>songID: Only return levels that use this official song number (2-21, unless you want hacked levels with songs from meltdown/subzero/etc. Also, Stereo Madness and Back on Track don't seem to work). Add the 'customSong' parameter to read the number as a custom song ID.</p>
<br>
<p><b>Params that require a string</b> (e.g. ?type=trending)</p>
<p>type: The type of search to perform, see <u>search types</u> below</p>
<br>
<p><b>Params that require anything</b> (e.g. ?mappack=yes or ?mappack)</p>
<p>featured: Only return featured levels</p>
<p>original: Only return non-copied levels</p>
<p>twoPlayer: Only return two player mode levels</p>
<p>coins: Only return levels with verified coins</p>
<p>epic: Only return levels with an epic rating</p>
<p>starred: Only return levels with a star rating</p>
<p>noStar: Only return levels without a star rating</p>
<p>customSong: Reads the 'song' parameter as a custom song ID instead of an official one</p>
<p>mappack: Reads the search query as the name of a map pack and returns the 3 levels if pack exists</p>
<p>user: Reads the search query as a player's ID and returns their levels</p>
<br>
<p><b>Search Types</b></p>
<p>All types ignore your search query and will return levels with any name.
<p>The API will return an array of each comment with the following information.<br>Values that don't work for profile posts are in <fontcolor=red>red</font></p>
<p>content: The comment text</p>
<p>likes: The number of likes the comment has</p>
<p>date: Time since the comment was posted (sent as "x days/weeks/months" ago, since it's all the API sends)</p>
<pclass="red">levelID: The ID of the level [COMMENT HISTORY ONLY]</p>
<pclass="red">username: The commenter's username</p>
<pclass="red">playerID: The commenter's ID</p>
<pclass="red">accountID: The commenter's account ID</p>
<pclass="red">form: The form of the commenter's icon</p>
<pclass="red">percent: The commenter's percent on the level, if provided</p>
<pclass="red">modColor: If the commenter is an elder mod and gets fancy green text</p>