API Coverage
This page documents which Geometry Dash API endpoints are implemented in gdpy.
Summary
| Category | Implemented | Total | Coverage |
| Accounts | 3 | 5 | 60% |
| Users | 4 | 4 | 100% |
| Levels | 10 | 11 | 91% |
| Comments | 7 | 7 | 100% |
| Songs | 3 | 6 | 50% |
| Social | 12 | 12 | 100% |
| Messages | 4 | 4 | 100% |
| Rewards | 2 | 3 | 67% |
| Lists | 1 | 3 | 33% |
| Misc | 2 | 2 | 100% |
| Total | 48 | 57 | 84% |
Legend
| Status | Meaning |
 Implemented | Fully working and tested |
 Partial | Implemented but may be incomplete |
 Not Implemented | Not yet available |
Accounts
| Endpoint | Method | Status | Notes |
accounts/loginGJAccount.php | login() | | Login with username/password |
accounts/registerGJAccount.php | register() | | Pre-2.2 API; rejects temp emails |
accounts/backupGJAccountNew.php | - | | Backup account (requires auth) |
accounts/syncGJAccountNew.php | - | | Sync account (requires auth) |
updateGJAccSettings20.php | update_account_settings() | | Update account settings (requires auth) |
Users
| Endpoint | Method | Status | Notes |
getGJUserInfo20.php | get_user() | | Get user by account ID |
getGJUsers20.php | search_users() | | Search users by name |
getGJScores20.php | get_leaderboard() | | Get global/creator leaderboard |
updateGJUserScore22.php | update_user_stats() | | Update user stats (requires auth) |
Levels
| Endpoint | Method | Status | Notes |
downloadGJLevel22.php | get_level() | | Download level by ID (includes level string) |
getGJLevels21.php | search_levels() | | Search levels |
getGJLevels21.php | get_user_levels() | | Get user's created levels (type=5) |
getGJDailyLevel.php | get_daily_level() | | Get daily/weekly/event level |
getGJGauntlets21.php | get_gauntlets() | | Get gauntlets |
getGJMapPacks21.php | get_map_packs() | | Get map packs |
uploadGJLevel21.php | upload_level() | | Upload level (requires auth) |
deleteGJLevelUser20.php | delete_level() | | Delete level (requires auth) |
reportGJLevel.php | report_level() | | Report level |
getGJLevelScores211.php | get_level_scores() | | Get level leaderboard (requires auth) |
updateGJDesc20.php | update_level_description() | | Update level description (requires auth) |
| Endpoint | Method | Status | Notes |
getGJComments21.php | get_level_comments() | | Get level comments |
getGJAccountComments20.php | get_account_comments() | | Get profile comments |
getGJCommentHistory.php | get_comment_history() | | Get user's comment history |
uploadGJComment21.php | post_level_comment() | | Post level comment (requires auth) |
uploadGJAccComment20.php | post_profile_comment() | | Post profile comment (requires auth) |
deleteGJComment20.php | delete_level_comment() | | Delete level comment (requires auth) |
deleteGJAccComment20.php | delete_profile_comment() | | Delete profile comment (requires auth) |
Songs
| Endpoint | Method | Status | Notes |
getGJSongInfo.php | get_song() | | Get song info by ID |
getGJTopArtists.php | get_top_artists() | | Get top artists |
testSong.php | test_song() | | Test song availability |
getCustomContentURL.php | - | | Get custom content URL |
musiclibrary_02.dat | - | | Music library |
sfxlibrary.dat | - | | SFX library |
Social
| Endpoint | Method | Status | Notes |
getGJFriendRequests20.php | get_friend_requests() | | Get friend requests (requires auth) |
uploadFriendRequest20.php | send_friend_request() | | Send friend request (requires auth) |
acceptGJFriendRequest20.php | accept_friend_request() | | Accept friend request (requires auth) |
deleteGJFriendRequests20.php | delete_friend_request() | | Delete friend request (requires auth) |
readGJFriendRequest20.php | read_friend_request() | | Mark friend request as read (requires auth) |
removeGJFriend20.php | remove_friend() | | Remove friend (requires auth) |
getGJUserList20.php | get_friends(), get_blocked_users() | | Get friends/blocked list (requires auth) |
blockGJUser20.php | block_user() | | Block user (requires auth) |
unblockGJUser20.php | unblock_user() | | Unblock user (requires auth) |
getGJMessages20.php | get_messages() | | Get messages (requires auth) |
downloadGJMessage20.php | get_message() | | Download message content (requires auth) |
uploadGJMessage20.php | send_message() | | Send message (requires auth) |
Rewards
| Endpoint | Method | Status | Notes |
getGJChallenges.php | get_challenges() | | Get daily quests (requires auth) |
getGJRewards.php | get_chest_rewards() | | Get chest rewards (requires auth) |
getGJSecretReward.php | - | | Secret vault reward (requires auth) |
Lists
| Endpoint | Method | Status | Notes |
getGJLevelLists.php | get_level_lists() | | Get level lists |
uploadGJLevelList.php | - | | Upload level list (requires auth) |
deleteGJLevelList.php | - | | Delete level list (requires auth) |
Misc
| Endpoint | Method | Status | Notes |
getTop1000.php | get_top_1000() | | Get top 1000 users |
likeGJItem211.php | like_level(), like_comment() | | Like an item (requires auth) |
Rewards
| Endpoint | Method | Status | Notes |
getGJChallenges.php | get_challenges() | | Get daily quests (requires auth) |
getGJRewards.php | get_chest_rewards() | | Get chest rewards (requires auth) |
getGJSecretReward.php | - | | Secret vault reward (requires auth) |
Missing Features
Requires Authentication
No Auth Required (Lower Priority)
Note: This coverage list is based on the Geometry Dash API documentation.