roblox-web-apis
roblox-web-apis copied to clipboard
List of Roblox web APIs
Roblox API Sites
| Site | Description |
|---|---|
| abtesting.roblox.com | Endpoints for the A/B Testing framework |
| accountinformation.roblox.com | All endpoints for acessing/modifying account information |
| accountsettings.roblox.com | All endpoints for account/user settings |
| adconfiguration.roblox.com | Roblox Ad Configuration related endpoints |
| ads.roblox.com | Ads configuration endpoints |
| api.roblox.com | Roblox Legacy Api Endpoints |
| assetdelivery.roblox.com | Serves asset content |
| auth.roblox.com | All endpoints that tamper with authentication sessions |
| avatar.roblox.com | Endpoints relating to the customization of player avatars |
| badges.roblox.com | Endpoints for badges and badge awards management |
| billing.roblox.com | Real money transactions and interaction |
| catalog.roblox.com | Catalog items browsing and searching. Content and user based catalog items recommendations |
| cdnproviders.roblox.com | Content delivery network providers API |
| chat.roblox.com | All chat and party related endpoints |
| clientsettings.roblox.com | Used by various Roblox clients to retrieve configuration information |
| clientsettingscdn.roblox.com | Used by various Roblox clients to retrieve configuration information |
| client-telemetry.roblox.com | Handles client telemtry |
| contentstore.roblox.com | ApiSite to front the TemporaryStore for files before uploading to S3 |
| contacts.roblox.com | Contacts and userTag management |
| develop.roblox.com | Game development configuration endpoints |
| discussions.roblox.com | Discussions API (temporarily offline) |
| economy.roblox.com | Endpoints related to transactions and currency |
| economycreatorstats.roblox.com | Roblox.EconomyCreatorStats.Api endpoints. |
| engagementpayouts.roblox.com | For engagement-based payout information |
| ephemeralcounters.api.roblox.com | Handles ephemeral counters |
| followings.roblox.com | Establishes follow relationship between subscriber entities (users, groups, etc) and source entities (games, groups, assets, etc.) |
| friends.roblox.com | Friends, followers, and contacts management |
| gameinternationalization.roblox.com | Manages internationalization of games such as translating in game content. |
| gamejoin.roblox.com | All endpoints around launching a game |
| gamepersistence.roblox.com | Endpoints for the in-game datastore system for storing data for games |
| games.roblox.com | All endpoints for game discovery, and details |
| groups.roblox.com | Groups management |
| groupsmoderation.roblox.com | Group Moderation |
| inventory.roblox.com | All endpoints for viewing (but not granting) ownership of items |
| itemconfiguration.roblox.com | Configure Items (bundles amd avatar assets) |
| lms.roblox.com | Status of the Latency Management Service |
| locale.roblox.com | User locale management |
| localizationtables.roblox.com | Handles managing of localization tables |
| metrics.roblox.com | Record metrics across Roblox |
| midas.roblox.com | Handle requests around making purchases using Midas |
| notifications.roblox.com | All notification stream endpoints |
| points.roblox.com | The web Api for the in-game PointsService |
| premiumfeatures.roblox.com | This API is for premium features and anything pertaining to account add ons |
| presence.roblox.com | All endpoints for managing presence |
| privatemessages.roblox.com | All messages page endpoints |
| publish.roblox.com | All endpoints handling file uploads |
| realtime.roblox.com | Purpose of API here |
| share.roblox.com | Purpose of Api here |
| search.roblox.com | Legacy item search endpoints. |
| textfilter.roblox.com | High volume text filtering |
| thumbnails.roblox.com | Endpoints for requesting thumbnails |
| thumbnailsresizer.roblox.com | Validate and resize thumbnails to requested dimensions |
| trades.roblox.com | Endpoints for trading collectible items |
| translationroles.roblox.com | Manages translation roles of developers in game localization |
| translations.roblox.com | Endpoints for requesting translations |
| twostepverification.roblox.com | Platform interface for the two step verification system |
| users.roblox.com | APIs for direct Roblox user information. |
| versioncompatability.api.roblox.com | Handles version compatability |
| voice.roblox.com | APIs for Voice calls |
Deprecated or poorly documented APIs
- Thumbnail APIs
- Search APIs
- Place APIs
- Universe APIs
- User APIs
- Asset APIs
- Login APIs
- Setup APIs
Search APIs
Returns a list of games.
http://www.roblox.com/games/list-json?sortFilter=1&MaxRows=5
Place APIs
Get a place's game instances
startIndex must be a multiple of 10
- https://www.roblox.com/games/getgameinstancesjson?placeId=1818&startindex=0
Get a list of allowed experimental features
- https://api.roblox.com/Game/GetAllowedExperimentalFeatures?placeId=1818
Universe APIs
Get the parent universe of place
- https://api.roblox.com/universes/get-universe-containing-place?placeid=1818
Thumbnail APIs
Asset Thumbnails
-
https://www.roblox.com/asset-thumbnail/image?assetId=1818&width=420&height=420&format=png
- Redirects to the URL.
-
https://www.roblox.com/Thumbs/RawAsset.ashx?assetId=1818&imageFormat=png&width=60&height=62
- Returns either
PENDINGor the URL. Also acceptsassetVersionId
- Returns either
-
https://assetgame.roblox.com/Thumbs/Asset.ashx?width=110&height=110&assetId=1818
- Redirects to the URL. Also accepts
userAssetId
- Redirects to the URL. Also accepts
-
https://assetgame.roblox.com/Thumbs/Asset.asmx/RequestThumbnail_v2?assetId=1818&assetVersionId=0&width=null&height=null&imageFormat=%22Png%22&thumbnailFormatId=296&overrideModeration=false
- Returns
{"d":{"final":true,"url":"https://t3.rbxcdn.com/5d84cad6c2dda6a98ec94341bd418076"}}
- Returns
-
https://assetgame.roblox.com/Game/Tools/ThumbnailAsset.ashx?aid=1818&fmt=png&wd=420&ht=420
-
https://assetgame.roblox.com/Game/Tools/ThumbnailAsset.ashx?assetVersionId=1&fmt=png&wd=420&ht=420
- Redirects to the URL
-
https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]
[{ id: 1818, name: "Crossroads", url: "/Crossroads-place?id=1818", thumbnailFinal true, thumbnailUrl: "https://t7.rbxcdn.com/134692bb990302f51fb8f52cfcdd8083", bcOverlayUrl: null, limitedOverlayUrl: null, deadlineOverlayUrl: null, limitedAltText: null, newOverlayUrl: null, imageSize: "large", saleOverlayUrl: null, iosOverlayUrl: null, transparentBackground: false }]You can specify the small image size (110x110) with params=[{assetId:1818,imageSize:small}]. Otherwise it will default to
large(420x420)Both of these APIs support JSONP, so this code can be embedded in any web page:
$.getJSON('https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]&jsoncallback=?', function(json) { alert(json[0].name); }); -
https://www.roblox.com/asset-thumbnail/json?assetId=1818&width=160&height=100&format=jpeg
{ "Url": "https://t3.rbxcdn.com/c51dd4f8a509b20061a065117450e4c5", "Final": true, "SubstitutionType": 0 }
Avatar Thumbnails
-
http://www.roblox.com/bust-thumbnail/json?userId=2025110&height=180&width=180
- Returns
{"Url":"https://tr.rbxcdn.com/6402a6d488e255d00967c2c021d29fb0/180/180/AvatarBust/Png","Final":true}
- Returns
-
https://www.roblox.com/headshot-thumbnail/json?userId=1390724&width=420&height=420
- Returns
{"Url":"https://tr.rbxcdn.com/cc62e75ca1f869e91fcc2ec1821a3b6e/420/420/AvatarHeadshot/Png","Final":true}
- Returns
-
https://www.roblox.com/Thumbs/Avatar.ashx?username=Shedletsky
- Redirects to the URL. Also accepts
userId, and all other parameters can be omitted. IfuserIdandusernameare both omitted, will return a ?
- Redirects to the URL. Also accepts
-
https://www.roblox.com/bust-thumbnail/image?userId=48103520&width=420&height=420&format=png
- Redirects to the URL.
-
https://www.roblox.com/headshot-thumbnail/image?userId=48103520&width=420&height=420&format=png
- Redirects to the URL.
-
https://www.roblox.com/avatar-thumbnails?params=[{userId:261}]
- Returns JSON
[{ "id": 261, "name": "Shedletsky", "url": "https://www.roblox.com/users/261/profile", "thumbnailFinal": true, "thumbnailUrl": "https://tr.rbxcdn.com/152bbbb5ba5953e40c91dd7e3dd0cf44/60/60/AvatarHeadshot/Png", "bcOverlayUrl": null, "substitutionType": 0 }]
Outfit Thumbnails
- https://www.roblox.com/outfit-thumbnail/image?userOutfitId=26415539&width=420&height=420&format=png
- Redirects to the URL.
Valid Thumbnail Sizes
| 48x48 | 60x62 | 75x75 | 100x100 | 110x110 | 160x100 | 250x250 | 352x352 | 420x230 | 420x420 | |
|---|---|---|---|---|---|---|---|---|---|---|
| /Game/Tools/ThumbnailAsset.ashx | x | x | x | x | ||||||
| /Asset-Thumbnail/Json | x | x | x | x | x | x | x | x | x | x |
| /Thumbs/Asset.ashx | x | x | x | x | x | x | x | x | x | x |
| /Thumbs/Avatar.ashx | x | x | x | x | x | x | x | x | x | x |
| /Thumbs/RawAsset.ashx | x | x | x | x | x | x | x | x | x | x |
User APIs
Get a user's profile games
-
https://www.roblox.com/users/profile/playergames-json?userId=261
{ "Title": "Games", "Games": [{ "CreatorID": 0, "CreatorName": "Shedletsky", "CreatorAbsoluteUrl": "https://www.roblox.com/users/261/profile", "Plays": 65437, "Price": 0, "ProductID": 0, "IsOwned": false, "IsVotingEnabled": true, "TotalUpVotes": 79, "TotalDownVotes": 34, "TotalBought": 0, "UniverseID": 150387, "HasErrorOcurred": false, "Favorites": 1728, "Description": "In a dystopian future, Robloxia is overrun by killbots.", "GameDetailReferralUrl": "https://www.roblox.com/games/refer?PlaceId=119445489&Position=1&PageType=Profile", "Thumbnail": { "Final": true, "Url": "https://t7.rbxcdn.com/ebfb8e2733d4e06b32db6c33b2f17ba3", "RetryUrl": null, "UserId": 0, "EndpointType": "Avatar" }, "UseDataSrc": false, "IsAsyncThumbnailEnabled": false, "GamePageResources": null, "Name": "Timmy and the Killbots", "PlaceID": 48891, "PlayerCount": 0, "ImageId": 0 }] }
Get information about the current user
Asset APIs
Get an asset's AssetVersioNId
- https://www.roblox.com/studio/plugins/info?assetId=1818
Upload an asset
POST /Data/Upload.ashx?assetid=1818 HTTP/1.1
Host: data.roblox.com
Cookie: .ROBLOSECURITY=*
Content-Type: application/xml; charset=utf-8
Content-Length: 17
<roblox></roblox>
Returns an assetVersionId
Insert asset APIs
- www.roblox.com/Game/Tools/InsertAsset.ashx?nsets=10&type=base
- www.roblox.com/Game/Tools/InsertAsset.ashx?type=user&userId=261&nsets=20
- www.roblox.com/Game/Tools/InsertAsset.ashx?sid=-7
Login APIs
Negotiation API
Setup APIs
Mobile version check
- https://www.roblox.com/MobileAPI/Check-App-Version?appVersion=AppiOSV2.112.35972