robloxpy 0.0.99

Wrapper for roblox Web API's

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
  • Prerequisites
  • Installation
  • RobloxPy Features
• Usage
  • Current Features
  • Usage Examples
    • External Functions
      • User Functions
        • LimitedRelated
      • Group Functions
      • Asset Functions
      • Game Functions
    • Internal Functions
      • User Functions
      • Group Functions
      • Game Functions

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 requests

pip install robloxpy

If you wish to update robloxpy in the future you can also do this through pip

pip install robloxpy --upgrade

RobloxPy

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.93

A 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 --upgrade

Usage

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)
    • UserCreationDate(UserID)
    • GetFollowingCount(UserID)
    • GetFollowersCount(UserID)
    • GetFollowers(UserID,Ammount)
    • GetFollowing(UserID,Ammount)
  • 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)

• 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)
    • SendMessage(Cookie,UserID,MessageSubject,Body)
  • 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)

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

• GetFollowingCount(UserID)

robloxpy.GetFollowingCount(1368140) #Get ammount of followers of user 1368140
Output > 16

• GetFollowerCount(UserID)

robloxpy.GetFollowingCount(1368140) #Get ammount of followers of user 1368140
Output > 12578

• GetFollowing(UserID,Ammount)

robloxpy.GetFollowing(1368140,10) # Get first 10 people being followed by 1368140
Output > (['takeovertom', 'dino5aur', 'iClanTech', '1waffle1', 'ForyxeV', 'Imaginze', 'StoryBased', 'LoneTraveler', 'beanme100', 'enyahs7'], [1096520, 649206, 65797433, 75323, 9622035, 17256624, 27572897, 3304627, 485933, 336048])

• GetFollowers(UserID,Ammount)

robloxpy.GetFollowing(1368140,10) # Get first 10 people being following user id 1368140
Output > (['builderman', 'Gaming112', 'snowbeat54321', 'BobHag', 'lilmigithunter', 'UchihaSasukePat', 'Alessi7953', 'GarraSabakuno', 'jangofettt', 'Garty983chub'], [156, 1359952, 2918062, 3149494, 2899616, 2937573, 2754369, 2982496, 20169, 169558])

• 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 > 389539

All 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 > True

Game-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 > 6754

GetCurrentUniverseVisits(UniverseID)

robloxpy.GetCurrentUniverseVisits(113491250) #Get the total visits of the universe with the ID of 113491250
output > 896375390

GetUniverseFavourites(UniverseID)

robloxpy.GetUniverseFavourites(113491250) #Get favourites of the universe with the ID of 113491250
output > 3971956

GetUniverseLikes(UniverseID)

robloxpy.GetUniverseLikes(113491250) #Get likes of the universe with the ID of 113491250
output > 1515099

GetUniverseDislikes(UniverseID

robloxpy.GetUniverseDislikes(113491250) #Get favourites of the universe with the ID of 113491250
output > 113053

---

---

---

---

Internal-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.com

---

Each 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 > True

RobloxPy 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 > True

RobloxPy 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 > True

Robloxpy 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']

• SendMessage(Cookie,UserID,MessageSubject,Body)

robloxpy.* SendMessage(ExampleCookie,1368140,'Important Message','Hey I sent this message using robloxpy') #Send a message to the user of id 1368140 with the subject 'Important Message' and a body of text of 'Hey I sent this message using robloxpy'

Output > Success

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 > 583

RobloxPy 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 > Sent

ChangeGroupRank(Cookie,GroupID,UserID,RoleID)

robloxpy.ChangeGroupRank(ExampleCookie,916576,1368140,5725003) #Change User 1368140 Role in group 916576 to RoleID 5725003
Output > Sent

ChangeGroupShout(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 > Sent

ChangeGroupDescription(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 > Sent

Internal-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 > 6754

robloxpy.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