Note
In Oct 2024, Roblox released a Legacy API Overview page which documents nearly all of the API sites detailed below. We recommend you start there.
| Site | Description |
|---|---|
| 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 |
| 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 |
| 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 telemetry |
| 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 |
| 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 and avatar assets) |
| lms.roblox.com | Status of the Latency Measurement Service |
| locale.roblox.com | User locale management |
| localizationtables.roblox.com | Handles managing of localization tables |
| metrics.roblox.com | Record metrics across Roblox |
| notifications.roblox.com | All notification stream endpoints |
| 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 |
| usermoderation.roblox.com | Endpoints for performing actions/operations related to User Moderation |
| users.roblox.com | APIs for direct Roblox user information. |
| voice.roblox.com | APIs for Voice calls |
https://apis.roblox.com/games-autocomplete/v1/get-suggestion/(partial name)
-
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/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 }]
| 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 |
| thumbnailFormatId | 2 | 24 | 280 | 41 | 47 | 163 | 114 | 124 | 8 | 254 |
-
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 }] }
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