Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/matthewdean/roblox-web-apis
List of Roblox web APIs
https://github.com/matthewdean/roblox-web-apis
roblox
Last synced: 6 days ago
JSON representation
List of Roblox web APIs
- Host: GitHub
- URL: https://github.com/matthewdean/roblox-web-apis
- Owner: matthewdean
- Created: 2013-12-06T21:25:28.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-09-11T20:25:08.000Z (3 months ago)
- Last Synced: 2024-09-12T06:36:10.955Z (3 months ago)
- Topics: roblox
- Language: JavaScript
- Homepage:
- Size: 283 KB
- Stars: 503
- Watchers: 19
- Forks: 74
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-roblox - ROBLOX Web APIs by matthewdean
- awesome-roblox - Roblox Web APIs - An unofficial list of all known web APIs on the Roblox site (Resources / Other)
README
> [!NOTE]
> In Oct 2024, Roblox released a [Legacy API Overview](https://create.roblox.com/docs/cloud/legacy) page which documents nearly all of the API sites detailed below. We recommend you start there.
Roblox API Sites
================
| Site | Description |
| -: | :- |
| [accountinformation.roblox.com](https://accountinformation.roblox.com//docs) | All endpoints for acessing/modifying account information |
| [accountsettings.roblox.com](https://accountsettings.roblox.com//docs) | All endpoints for account/user settings |
| [adconfiguration.roblox.com](https://adconfiguration.roblox.com//docs) | Roblox Ad Configuration related endpoints |
| [ads.roblox.com](https://ads.roblox.com//docs) | Ads configuration endpoints |
| [assetdelivery.roblox.com](https://assetdelivery.roblox.com//docs) | Serves asset content |
| [auth.roblox.com](https://auth.roblox.com//docs) | All endpoints that tamper with authentication sessions |
| [avatar.roblox.com](https://avatar.roblox.com//docs) | Endpoints relating to the customization of player avatars |
| [badges.roblox.com](https://badges.roblox.com//docs) | Endpoints for badges and badge awards management |
| [billing.roblox.com](https://billing.roblox.com//docs) | Real money transactions and interaction |
| [catalog.roblox.com](https://catalog.roblox.com//docs) | Catalog items browsing and searching. Content and user based catalog items recommendations |
| [chat.roblox.com](https://chat.roblox.com//docs) | All chat and party related endpoints |
| [clientsettings.roblox.com](https://clientsettings.roblox.com//docs) | Used by various Roblox clients to retrieve configuration information |
| [clientsettingscdn.roblox.com](https://clientsettingscdn.roblox.com//docs) | Used by various Roblox clients to retrieve configuration information |
| [client-telemetry.roblox.com](https://client-telemetry.roblox.com//docs) | Handles client telemetry |
| [contentstore.roblox.com](https://contentstore.roblox.com//docs) | ApiSite to front the TemporaryStore for files before uploading to S3 |
| [contacts.roblox.com](https://contacts.roblox.com//docs) | Contacts and userTag management |
| [develop.roblox.com](https://develop.roblox.com//docs) | Game development configuration endpoints |
| [economy.roblox.com](https://economy.roblox.com//docs) | Endpoints related to transactions and currency |
| [economycreatorstats.roblox.com](https://economycreatorstats.roblox.com//docs) | Roblox.EconomyCreatorStats.Api endpoints. |
| [engagementpayouts.roblox.com](https://engagementpayouts.roblox.com//docs) | For engagement-based payout information |
| [ephemeralcounters.api.roblox.com](https://ephemeralcounters.api.roblox.com//docs) | Handles ephemeral counters |
| [followings.roblox.com](https://followings.roblox.com//docs) | Establishes follow relationship between subscriber entities (users, groups, etc) and source entities (games, groups, assets, etc.) |
| [friends.roblox.com](https://friends.roblox.com//docs) | Friends, followers, and contacts management |
| [gameinternationalization.roblox.com](https://gameinternationalization.roblox.com//docs) | Manages internationalization of games such as translating in game content. |
| [gamejoin.roblox.com](https://gamejoin.roblox.com//docs) | All endpoints around launching a game |
| [gamepersistence.roblox.com](https://gamepersistence.roblox.com//docs) | Endpoints for the in-game datastore system for storing data for games |
| [games.roblox.com](https://games.roblox.com//docs) | All endpoints for game discovery, and details |
| [groups.roblox.com](https://groups.roblox.com//docs) | Groups management |
| [groupsmoderation.roblox.com](https://groupsmoderation.roblox.com//docs) | Group Moderation |
| [inventory.roblox.com](https://inventory.roblox.com//docs) | All endpoints for viewing (but not granting) ownership of items |
| [itemconfiguration.roblox.com](https://itemconfiguration.roblox.com//docs) | Configure Items (bundles and avatar assets) |
| [lms.roblox.com](https://lms.roblox.com//docs) | Status of the Latency Measurement Service |
| [locale.roblox.com](https://locale.roblox.com//docs) | User locale management |
| [localizationtables.roblox.com](https://localizationtables.roblox.com//docs) | Handles managing of localization tables |
| [metrics.roblox.com](https://metrics.roblox.com//docs) | Record metrics across Roblox |
| [notifications.roblox.com](https://notifications.roblox.com//docs) | All notification stream endpoints |
| [premiumfeatures.roblox.com](https://premiumfeatures.roblox.com//docs) | This API is for premium features and anything pertaining to account add ons |
| [presence.roblox.com](https://presence.roblox.com//docs) | All endpoints for managing presence |
| [privatemessages.roblox.com](https://privatemessages.roblox.com//docs) | All messages page endpoints |
| [publish.roblox.com](https://publish.roblox.com//docs) | All endpoints handling file uploads |
| [realtime.roblox.com](https://realtime.roblox.com//docs) | Purpose of API here |
| [share.roblox.com](https://share.roblox.com//docs) | Purpose of Api here |
| [search.roblox.com](https://developer.roblox.com/en-us/articles/Catalog-API) | Legacy item search endpoints. |
| [textfilter.roblox.com](https://textfilter.roblox.com//docs) | High volume text filtering |
| [thumbnails.roblox.com](https://thumbnails.roblox.com//docs) | Endpoints for requesting thumbnails |
| [thumbnailsresizer.roblox.com](https://thumbnailsresizer.roblox.com//docs) | Validate and resize thumbnails to requested dimensions |
| [trades.roblox.com](https://trades.roblox.com//docs) | Endpoints for trading collectible items |
| [translationroles.roblox.com](https://translationroles.roblox.com//docs) | Manages translation roles of developers in game localization |
| [translations.roblox.com](https://translations.roblox.com//docs) | Endpoints for requesting translations |
| [twostepverification.roblox.com](https://twostepverification.roblox.com//docs) | Platform interface for the two step verification system |
| [usermoderation.roblox.com](https://usermoderation.roblox.com//docs) | Endpoints for performing actions/operations related to User Moderation |
| [users.roblox.com](https://users.roblox.com//docs) | APIs for direct Roblox user information. |
| [voice.roblox.com](https://voice.roblox.com//docs) | APIs for Voice calls |
Deprecated or poorly documented APIs
===============
* [Thumbnail APIs](#thumbnail-apis)
* [User APIs](#user-apis)
* [Asset APIs](#asset-apis)
* [Search APIs](#search-apis)
* [Setup APIs](#setup-apis)
Search APIs
-----------
#### Returns a list of suggested content based on autocomplete.
https://apis.roblox.com/games-autocomplete/v1/get-suggestion/(partial name)
Thumbnail APIs
--------------
#### Asset Thumbnails
* https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]
```javascript
[{
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:
```javascript
$.getJSON('https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]&jsoncallback=?', function(json) {
alert(json[0].name);
});
```
#### Avatar Thumbnails
* https://www.roblox.com/avatar-thumbnails?params=[{userId:261}]
* Returns JSON
```javascript
[{
"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
#### 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 |
| thumbnailFormatId | 2 | 24 | 280 | 41 | 47 | 163 | 114 | 124 | 8 | 254 |
User APIs
----
#### Get a user's profile games
* https://www.roblox.com/users/profile/playergames-json?userId=261
```json
{
"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
}]
}
```
Asset APIs
----------
#### Upload an asset
```http
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
```
Returns an assetVersionId
Setup APIs
----------
#### Mobile version check
* https://www.roblox.com/MobileAPI/Check-App-Version?appVersion=AppiOSV2.112.35972
#### Downloads and version endpoints
* [setup.rbxcdn.com](http://setup.rbxcdn.com)
* [/Roblox.exe](http://setup.rbxcdn.com/Roblox.exe)
* [/RobloxStudioLauncher.exe](http://setup.rbxcdn.com/RobloxStudioLauncher.exe)
* [/RobloxStudioLauncherBeta.exe](http://setup.rbxcdn.com/RobloxStudioLauncherBeta.exe)
* [/cdn.txt](http://setup.rbxcdn.com/cdn.txt)
* [/version(.txt)](http://setup.rbxcdn.com/version)
* [/versionStudio(.txt)](http://setup.rbxcdn.com/versionStudio)
* [/versionQTStudio](http://setup.rbxcdn.com/versionQTStudio)
* [/DeployHistory.txt](http://setup.rbxcdn.com/DeployHistory.txt)
* [/mac/version](http://setup.rbxcdn.com/mac/version)
* [/mac/versionStudio](http://setup.rbxcdn.com/mac/versionStudio)
* [/mac/RobloxStudio.dmg](http://setup.rbxcdn.com/mac/RobloxStudio.dmg)
* [/mac/DeployHistory.txt](http://setup.rbxcdn.com/mac/DeployHistory.txt)