RobloxPyOfficial
RobloxPy is a python API wrapper for the roblox web api's. This allows for quick and easy integration of these API's into a python project.
Table of Contents
Getting-Started
To use the wrapper you will need to download and import robloxpy into your current project. The project has not external requirements that is not included within the defaults of a python install.
Prerequisites
N/A
Installation
Before you can import robloxpy you will first need to install it through pip Requirements:
pip install requestspip install robloxpyIf you wish to update robloxpy in the future you can also do this through pip
pip install robloxpy --upgradeRobloxPy
RobloxPy includes some simple functions to help you get the information you need about it, these functions can be used as a check to ensure that the user is using a minimum version you deem necesarry for your RobloxPy project to work.
- CheckForUpdate This function can provide two different outputs, one that the current version being used it the latest or the current version that is availible to update to
robloxpy.CheckForUpdate()
Output > You are up to date!robloxpy.CheckForUpdate()
Output > Version 0.0.94 is now availible- CheckVersion
robloxpy.CheckVersion()
Output > 0.0.93A function can also be called to give the user instructions on how to update RobloxPy. This function will provide the latest reccomended way to upgrade RobloxPy
- HowToUpdate
robloxpy.HowToUpdate()
Output > pip install robloxpy --upgradeUsage
This section will cover what is currently supported by the API and how they can be used
Features
-
RobloxPy
- CheckForUpdate()
- CheckVersion()
- HowToUpdate()
-
External
- User
- NameToID(UserName)
- GetName(UserID)
- DoesNameExist(UserName)
- IsOnline(UserID)
- GetFriends(UserID)
- GetOnlineFriends(UserID)
- GetOfflineFriends(UserID)
- GetUserGroups(UserID)
- DoesNameExist(UserName)
- IsBanned(UserID)
- AccountAgeDays(UserID)
- AccountCreationYear(UserID)
- RAP
- GetUserRap(UserID)
- GetUserLimitedValue(UserID)
- GetUserNoDemandLimiteds(UserID)
- GetUserLowDemandLimiteds(UserID)
- GetUserNormalDemandLimiteds(UserID)
- GetUserGoodDemandLimiteds(UserID)
- GetUserTerribleDemandLimiteds(UserID)
- Group
- IsGroupOwned(GroupID)
- GetGroupName(GroupID)
- GetGroupDescription(GroupID)
- GetGroupShout(GroupID)
- IsGroupOpen(GroupID)
- GetGroupMembers(GroupID)
- GetGroupAllies(GroupID)
- GetGroupEnemies(GroupID)
- Assets
- CanManage(UserID,GroupID)
- Game
- GetUniverseFavourites(UniverseID)
- GetCurrentUniversePlayers(UniverseID)
- GetUniverseVisits(UniverseID)
- GetUniverseLikes(UniverseID)
- GetUniverseDislikes(UniverseID)
- User
-
Internal
- User
- GetUserID(Cookie)
- GetUserName(Cookie)
- GetEmail(Cookie)
- IsEmailVerified(Cookie)
- CanTrade(Cookie)
- IsOver13(Cookie)
- IsTwoStepEnabled(Cookie)
- IsAccountPinEnabled(Cookie)
- GetRobux(Cookie)
- IsPremium(Cookie)
- GetAvatar(Cookie)
- IsFollowing(Cookie, UserID)
- FollowUser(Cookie, UserID)
- UnfollowUser(Cookie, UserID)
- BlockUser(Cookie, UserID)
- UnblockUser(Cookie, UserID)
- SendFriendRequest(Cookie,UserID)
- Unfriend(Cookie,UserID)
- TotalFriends(Cookie)
- GetBlockedUsers(Cookie)
- Group
- ClaimGroup(Cookie,GroupID)
- JoinGroup(Cookie,GroupID)
- LeaveGroup(Cookie,GroupID)
- GetFunds(Cookie,GroupID)
- PayGroupFunds(Cookie,GroupID,UserID,RobuxAmount)
- PayGroupPercentage(Cookie,GroupID,UserID,Percentage)
- PostGroupWall(Cookie,GroupID,Text)
- ChangeGroupRank(Cookie,GroupID,UserID,RoleID)
- Game
- GetCurrentGamePlayers(Cookie,PlaceID)
- GetGameVisits(Cookie,PlaceID)
- GetGameLikes(Cookie,PlaceID)
- GetGameDislikes(Cookie,PlaceID)
- GetGameFavourites(Cookie,PlaceID)
- ChangeGroupShout(Cookie,GroupID,StatusString)
- ChangeGroupDescription(Cookie,GroupID,DescriptionString)
- User
Examples
Below are examples of how to use each of the functions within robloxpy
External-Functions
These functions do not require any cookies can be used without any data, these are limited to GET based on what roblox provides
-
User-Functions
These functions allow you to get data in regards to a specific user through the use of their UserID or UserName
- NameToID(UserName)
robloxpy.NameToID('kristan99') #Get the UserID of the roblox user with the name kristan99
Output > 1368140- GetName(UserID)
robloxpy.GetName(1368140) #Get the name of the roblox user with the ID of 1368140
Output > kristan99- DoesNameExist(UserName)
robloxpy.DoesNameExist('kristan99') #Check if the username 'kristan99' is availible to take
Output > Unavailible- IsOnline(UserID)
robloxpy.IsOnline(1368140) #Check if the user with the ID 1368140 is online
Output > False- GetFriends(UserID)
robloxpy.GetFriends(1368140) #Return a list of all friends of the roblox user with the ID 1368140
Output > ['SlimemingPlayz', 'E_xitium', 'Kawaii_Katicorn99', 'KatieeLouisee99', 'Yung_nignogpaddywog', 'BigDDave', 'Nosowl', 'Mirro_rs', 'Gareth1990', 'Voxxes', 'matantheman', 'ItzDishan', 'Xulfite', 'CinnabonNinja', 'hotrod56478', 'roxo_pl', 'VIPOrder', 'GlowwLikeThat', 'BritishP0litics', 'Nicolas9970', 'YunPlant', 'sirjoshh', 'iMistifye', 'Scorp1x', 'Fribbzdaman', 'xMcKenziee', 'AjinKovac', 'Angels_Develop', 'RonerRehnskiold', 'Natty32', 'agnen', 'yusufrad22', 'RocketValkyrie', 'methanshacked', 'GingyWyven', 'KingsmanSS', 'glitch19']- GetOnlineFriends(UserID)
robloxpy.GetOnlineFriends(1368140) #Get a list of online friends of the roblox user with the ID 1368140
Output > ['Mirro_rs', 'Natty32']- GetOfflineFriends(UserID)
robloxpy.GetOfflineFriends(1368140) #Get a list of offline friends of the roblox user with the ID 1368140
Output > ['SlimemingPlayz', 'E_xitium', 'Kawaii_Katicorn99', 'KatieeLouisee99', 'Yung_nignogpaddywog', 'BigDDave', 'Nosowl', 'Gareth1990', 'Voxxes', 'matantheman', 'ItzDishan', 'Xulfite', 'CinnabonNinja', 'hotrod56478', 'roxo_pl', 'VIPOrder', 'GlowwLikeThat', 'BritishP0litics', 'Nicolas9970', 'YunPlant', 'sirjoshh', 'iMistifye', 'Scorp1x', 'Fribbzdaman', 'xMcKenziee', 'AjinKovac', 'Angels_Develop', 'RonerRehnskiold', 'agnen', 'yusufrad22', 'RocketValkyrie', 'methanshacked', 'GingyWyven', 'KingsmanSS', 'glitch19']- GetUserGroups(UserID)
robloxpy.GetUserGroups(1368140) #Get a list of groups which the user belongs too
Output > (['Simple Studio', 'BlackRock Studio', 'White Wolf Hounds', '🌶️Hot Pepper Clothes', 'Twisted Murder er Official Group', 'StarCraft®', 'United Alliance Of Roblox', 'NEVER WALK ALONE'], [3297855, 847360, 1201505, 3206677
1225381, 1132763, 14195, 916576])- IsBanned(UserID)
robloxpy.IsBanned(1368140) # Get whether user ID belongs to a terminated account
Output > False- AccountAgeDays(UserID)
robloxpy.AccountAgeDays(1) #How many days ago was the account with the ID or 1 created
Output > 5246- UserCreationDate(UserID,WantedData)
The WantedData variable for this function is not case sensistive however it must be spelt correctly
- Year
- Month
- Day
robloxpy.UserCreationDate(1,'Year') # Request the year the account was created
Output > 2006-
Limited-Functions
These functions relate to getting the value of a user based on their limiteds
- GetUserRAP(UserID)
robloxpy.GetUserRap(1368140) # Get the RAP of the user with the ID 1368140
Output > 298202- GetUserLimitedValue(UserID)
robloxpy.GetUserLimitedValue(1368140) # Get the RAP of the user with the ID 1368140
Output > 389539All the functions to determine the quality of a users items are the same just switching the type each providing a similiar output
- GetUserTerribleDemandLimiteds(UserID)
robloxpy.GetUserTerribleDemandLimiteds(1368140) # Get limiteds considered terrible and undesired by the user with the ID 1368140
Output > 0-
Group-Functions
These functions allow you to get data in regards to a specific group
IsGroupOwned(GroupID)
robloxpy.IsGroupOwned(916576) # Check if the group of the ID 916576 is owned
Output > True- GetGroupName(GroupID)
robloxpy.GetGroupName(916576) # Get the name of the group of the ID 916576
Output > NEVER WALK ALONE- GetGroupDescription(GroupID)
robloxpy.GetGroupDescription(916576) # Get the description of the group of the ID 916576
Output > [NWA]Never Walk Alone
NWA is a PMC style group that aims for perfection and are looking for all types of members to join to help us with our goal.
We like active members at NWA and have a wide range of bots to help the group function with things such as
- Automatic Promotion
- Inactivity Detector
[Automatic Promotions]
{Temp Down Will Be Up Within 1 Week}
[Inactivity Kicked]
{Online - Set to 30 Days}- GetGroupShout(GroupID)
robloxpy.GetGroupShout(916576) # Get the current shout of the group of the ID 916576
Output > How are you?- IsGroupOpen(GroupID)
robloxpy.IsGroupOpen(916576) # Check if the group of the ID 916576 is open to join
Output > True- GetGroupMembers(GroupID)
robloxpy.GetGroupMembers(916576) # Get member count of the group of the ID 916576
Output > 1361- GetGroupAllies(GroupID)
robloxpy.GetGroupAllies(916576) # Get all the allies associated with the group of the ID 916576
Output > ['Akios', 'Dank']- GetGroupEnemies(GroupID)
robloxpy.GetGroupAllies(916576) # Get all the enemies associated with the group of the ID 916576
Output > ['United Alliance Of Roblox']Asset-Functions
These functions allow you to get data in regards to a specific asset
- CanManage(UserID,AssetID)
robloxpy.CanManage(1368140,240351460)
Output > TrueGame-Functions
These functions are to get data about roblox games, this functions require a universeID which can only be obtained when using a cookie. If you wish to automate this and instead use the GameID please use the internal version of these functions.
GetCurrentUniversePlayers(UniverseID)
robloxpy.GetCurrentUniversePlayers(113491250) #Get current player count of the universe with the ID of 113491250
output > 6754GetCurrentUniverseVisits(UniverseID)
robloxpy.GetCurrentUniverseVisits(113491250) #Get the total visits of the universe with the ID of 113491250
output > 896375390GetUniverseFavourites(UniverseID)
robloxpy.GetUniverseFavourites(113491250) #Get favourites of the universe with the ID of 113491250
output > 3971956GetUniverseLikes(UniverseID)
robloxpy.GetUniverseLikes(113491250) #Get likes of the universe with the ID of 113491250
output > 1515099GetUniverseDislikes(UniverseID
robloxpy.GetUniverseDislikes(113491250) #Get favourites of the universe with the ID of 113491250
output > 113053Internal-Functions
These functions require a cookie of the user account they wish to be run on as a variable. These functions allow support for both POST and GET requests allowing actions to be taken on an account.
Internal-User-Functions
These functions are specific to actions related to the account of the cookies being used. Since roblox cookies are looooooong I will be using 'ExampleCookie' as a placeholder, below is an example of how you may do this within your program. This cookie is not real and randomly generated following the requirements
ExampleCookie = '_|WARNING:-DO-NOT-SHARE-THIS.--Sharing-this-will-allow-someone-to-log-in-as-you-and-to-steal-your-ROBUX-and-items.|_A292F2A0D15508456743D0472FCBF81E081677B96500C348C08C6D3009975DA56D4D1BE762BB225C26A960FEC6746A932C46CFD7364B2F646758731949B6F8C8288F9C628D6AD4DB90C7F1A1BD1EA54AD4169C51AD081561E230C31974366ADEF1726A4490940262EB9D694457C58E48C8385C9D426F0C2A247206DF0E149F675107EB0B60DE5173E5D8556F93CFD6104E786727E6C86A8E8F4CF3B8DEEA0CCE447159BE0D7AB6E16FD193C85526E2BC928F7B90EA5146EC7A243AF98D72EDBCF2154839A8078DAA60F048FFDC67B7367C5E6EE6F7BC5AF902CAB331F66B96310015BB93225E9D4242CD5A4FC2D20321576D268F84A3EBBD752FA80CAF30D73525A9C764FFFE718345EF864235F910EAEB49ED5537AD2432A3A74F9A3AF1B4F5B9C5B2C0'- GetUserName(Cookie)
robloxpy.GetUserName(ExampleCookie) #Get Name of the current cookie in use
Output > Builderman- GetEmail(Cookie)
robloxpy.GetEmail(ExampleCookie) #Get Email of the current cookie in use
Output > Fa********@email.comEach of these functions will return a true or false relevant to what is being checked
- IsEmailVerified(Cookie)
- CanTrade(Cookie)
- IsOver13(Cookie)
- IsTwoStepEnabled(Cookie)
- IsAccountPinEnabled(Cookie)
- GetRobux(Cookie)
robloxpy.GetUserName(ExampleCookie) #Get Robux of the current cookie in use
Output > 5000- IsPremium(Cookie)
robloxpy.IsPremium(ExampleCookie) #Check if cookie user is premium
Output > TrueRobloxPy has the ability to follow and unfollow users for the cookie currently being used, these functions will provide a true or false value based on if it was a success; alternatively any errors that occur will be returned to the user also.
- IsFollowing(Cookie, UserID)
robloxpy.IsFollowing(ExampleCookie,1368140) #Check if cookie user is following user with the ID 1368140
Output > True- FollowUser(Cookie, UserID)
robloxpy.FollowUser(ExampleCookie,1368140) #Follow user with ID 1368140
Output > True- UnfollowUser(Cookie, UserID)
robloxpy.UnfollowUser(ExampleCookie,1368140) #Unfollow user with ID 1368140
Output > TrueRobloxPy has the ability to block and unblock users for the cookie currently being used, these functions will provide a true or false value based on if it was a success; alternatively any errors that occur will be returned to the user also
- BlockUser(Cookie, UserID)
robloxpy.BlockUser(ExampleCookie,1368140) #Block the user with ID 1368140
Output > True- UnblockUser(Cookie, UserID)
robloxpy.UnblockUser(ExampleCookie,1368140) #Unblock the user with ID 1368140
Output > TrueRobloxpy allows you to send friend requests to users or to unfriend or cancel a friend request. The 'SendFriendRequest' function will provide the output of success or return an error message. The 'Unfriend' function will return either a sent confirmation or error depending on the response from the server.
- SendFriendRequest(Cookie, UserID)
robloxpy.SendFriendRequest(ExampleCookie,1368140) #Send a friend request to the user with ID 1368140
Output > success- Unfriend(Cookie, UserID)
robloxpy.Unfriend(ExampleCookie,1368140) #Unfriend the user with ID 1368140
Output > sent- TotalFriends(Cookie, UserID)
robloxpy.TotalFriends(ExampleCookie) #Total friends of the local user
Output > 5- GetBlockedUsers(Cookie) This function allows you to get just the ID of the users or also the names by parsing the returning data from when called
robloxpy.GetBlockedUsers(ExampleCookie) #Get a list of ID's and Names of users blocked by the cookie account
Output > [1267895826, 1604596527, 1731797857], ['MiguelXXcoolXXplayz', 'CaduboyYT', 'Edson5380']Internal-Group-Functions
The functions require the use of a cookie that can be used to get the information required.
- ClaimGroup(Cookie,GroupID)
robloxpy.JoinGroup(ExampleCookie,916576) #Claim ownership of group with the ID 916576 if possible
Output > Sent- JoinGroup(Cookie,GroupID)
robloxpy.JoinGroup(ExampleCookie,916576) #Join group with the ID 916576 if possible
Output > Joined- LeaveGroup(Cookie,GroupID)
robloxpy.LeaveGroup(ExampleCookie,916576) #Leave group with the ID 916576 if possible
Output > Left- GetFunds(Cookie,GroupID)
robloxpy.GetFunds(ExampleCookie,916576) #Get funds of 916576 if they can be spent
Output > 583RobloxPy supports the payout of group funds in both a percentage and value capacity. The functions also support a small ammount of error checking confirming if the payment was reported as being sent or not.
- PayGroupFunds(Cookie,GroupID,UserID,RobuxAmmount)
robloxpy.PayGroupFunds(ExampleCookie,916576,1368140,100) #Get 100 robux from group ID 916576 if they can be spent
Output > Sent- PayGroupPercentage(Cookie,GroupID,UserID,RobuxAmmount)
robloxpy.PayGroupPercentage(ExampleCookie,916576,1368140,100) #Get 100 robux from group ID 916576 if they can be spent
Output > Sent- PostGroupWall(Cookie,GroupID,Text)
robloxpy.PostGroupWall(ExampleCookie,916576,'Hello World') #Send a post to the wall of group ID 916576
Output > SentChangeGroupRank(Cookie,GroupID,UserID,RoleID)
robloxpy.ChangeGroupRank(ExampleCookie,916576,1368140,5725003) #Change User 1368140 Role in group 916576 to RoleID 5725003
Output > SentChangeGroupShout(Cookie,GroupID,StatusString)
robloxpy.ChangeGroupShout(ExampleCookie,916576,'This is a new group shout') #Set the group shout to 'This is a new group shout' in the group with the ID 916576
Output > SentChangeGroupDescription(Cookie,GroupID,DescriptionString)
robloxpy.ChangeGroupDescription(ExampleCookie,916576,'This is a new group description') #Set the group shout to 'This is a new group description' in the group with the ID 916576
Output > SentInternal-Game-Functions
These functions require the use of a cookie to authenticate with the roblox server to allow it to get the UniverseID for games, if you already have the UniverseeID you can use the external functions above.
- GetUniverseID(Cookie,GameID)
robloxpy.GetUniverseID(ExampleCookie,292439477) #Convert GameID to UniverseID
Output > 113491250- GetCurrentGamePlayers(Cookie,GameID)
robloxpy.GetCurrentGamePlayers(ExampleCookie,292439477) #Get current playercount of game
Output > 6754robloxpy.GetGameVisits(ExampleCookie,GameID)
robloxpy.GetGameVisits(ExampleCookie,292439477) #Get total visits of the game
output > 896375390- GetGameLikes(Cookie,GameID)
robloxpy.GetGameLikes(ExampleCookie,292439477) #Get game likes
Output > 1515099- GetGameDislikes(Cookie,GameID)
robloxpy.GetGameDislikes(ExampleCookie,292439477) #Get game dislikesD
Output > 113053- GetGameFavourites(Cookie,GameID)
robloxpy.GetGameFavourites(ExampleCookie,292439477) #Get game favourites
Output > 3971956
