anandvc / roblox-web-apis

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 PENDING or the URL. Also accepts assetVersionId

• https://assetgame.roblox.com/Thumbs/Asset.ashx?width=110&height=110&assetId=1818

  • Redirects to the URL. Also accepts userAssetId

• 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"}}

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

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

• https://www.roblox.com/Thumbs/Avatar.ashx?username=Shedletsky

  • Redirects to the URL. Also accepts userId, and all other parameters can be omitted. If userId and username are both omitted, will return a ?

• 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

• https://www.roblox.com/MobileAPI/UserInfo

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

• https://www.roblox.com/Login/Negotiate.ashx?suggest=

Setup APIs

Mobile version check

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

Downloads and version endpoints

• setup.roblox.com
  • /Roblox.exe
  • /RobloxStudioLauncher.exe
  • /RobloxStudioLauncherBeta.exe
  • /cdn.txt
  • /version(.txt)
  • /versionStudio(.txt)
  • /versionQTStudio
  • /DeployHistory.txt
  • /mac/version
  • /mac/versionStudio
  • /mac/RobloxStudio.dmg
  • /mac/DeployHistory.txt