roblox-web-apis Documentation

Roblox hosts various specialized API sites for different functionalities. While many are documented in the Legacy API Overview, this repository provides a reference for several key sites.

Note: For most modern development, it is recommended to start with the official Roblox Cloud/Legacy documentation.

Retrieve avatar thumbnails for a specific user ID. The endpoint returns a JSON array containing the user's name, profile URL, and the thumbnailUrl.

// Requesting an avatar thumbnail
https://www.roblox.com/avatar-thumbnails?params=[{userId:261}]

Retrieve thumbnails for specific assets using the item-thumbnails endpoint.

By default, the API returns a large (420x420) image. To request a small (110x110) image, include imageSize:small in the params object.

Both the asset and avatar thumbnail APIs support JSONP for client-side embedding.

// Requesting a large thumbnail (default)
https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]

// Requesting a small thumbnail (110x110)
https://www.roblox.com/item-thumbnails?params=[{assetId:1818,imageSize:small}]

// Example using JSONP with jQuery
$.getJSON('https://www.roblox.com/item-thumbnails?params=[{assetId:1818}]&jsoncallback=?', function(json) {
    alert(json[0].name);
});

Verify the version of the Roblox mobile application using the MobileAPI/Check-App-Version endpoint.

https://www.roblox.com/MobileAPI/Check-App-Version?appVersion=AppiOSV2.112.35972

Use the games-autocomplete API to retrieve a list of suggested content based on a partial name provided by the user.

https://apis.roblox.com/games-autocomplete/v1/get-suggestion/(partial name)

Retrieve a list of games associated with a specific user's profile in JSON format. The response includes details such as CreatorName, Plays, Price, UniverseID, and PlaceID.

https://www.roblox.com/users/profile/playergames-json?userId=261

Upload an asset to data.roblox.com. This requires a valid .ROBLOSECURITY cookie for authentication. The request body should be an XML structure <roblox></roblox>. A successful upload returns an assetVersionId.

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>

The following endpoints on setup.rbxcdn.com are used for downloading Roblox executables, checking versions, and accessing deployment history.

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)