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	Purpose of Api here
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
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
economy.roblox.com	Endpoints related to transactions and currency
economycreatorstats.roblox.com	Roblox.EconomyCreatorStats.Api endpoints.
engagementpayouts.roblox.com	For engagement-based payout information
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)
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
share.roblox.com	Purpose of Api here
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.
voice.roblox.com	APIs for Voice calls

Deprecated APIs

• Thumbnail APIs
• Set APIs
• Group APIs
• Friend APIs
• User APIs
• Asset APIs

Search APIs

http://www.roblox.com/games/list-json?sortFilter=1&MaxRows=5

Search for an audio asset with the search term "pendulum fasten"

https://search.roblox.com/catalog/json?Category=9&Keyword=pendulum%20fasten

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

Thumbnail APIs

Asset Thumbnails

• 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://www.roblox.com/headshot-thumbnail/json?userId=1&width=180&height=180

  • Returns {"Url":"https://tr.rbxcdn.com/c3ee609e91804ee2f15c6375355a381a/180/180/AvatarHeadshot/Png","Final":true}

• 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

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

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

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

Group APIs

Get a thumbnail for a group

• https://www.roblox.com/group-thumbnails?params=[{groupId:1}]

Get a user's role in all their groups

• https://groups.roblox.com/v1/users/261/groups/roles

Get a group's ranks

• https://groups.roblox.com/docs#!/Membership/get_v1_groups_groupId_roles'

Get a user's primary group

• https://groups.roblox.com/docs#!/PrimaryGroup/get_v1_users_userId_groups_primary_role

Product APIs

Get information about a product

• https://api.roblox.com/Marketplace/ProductDetails?productId=18026036

  {
      "AssetId": 0,
      "ProductId": 18026036,
      "Name": "85 Candies Pack",
      "Description": null,
      "AssetTypeId": 0,
      "Creator": {
          "Id": 0,
          "Name": null
      },
      "IconImageAssetId": 0,
      "Created": "2013-10-16T00:37:38.517Z",
      "Updated": "2013-10-16T00:37:38.517Z",
      "PriceInRobux": 50,
      "IsNew": false,
      "IsForSale": true,
      "IsPublicDomain": false,
      "IsLimited": false,
      "IsLimitedUnique": false,
      "Remaining": null,
      "MinimumMembershipLevel": 0
  }

User APIs

Get username from ID

• https://api.roblox.com/users/261

  {
      "Id": 261,
      "Username": "Shedletsky"
  }

Get ID from username

• https://api.roblox.com/users/get-by-username?username=ROBLOX

  {
      "Id": 1,
      "Username": "ROBLOX"
  }

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

Asset APIs

Get parts of a package

• https://inventory.roblox.com/v1/packages/27133145/assets

Check if a user owns an asset

• http://api.roblox.com/Ownership/HasAsset?userId=261&assetId=1818

  false

Get information about an asset

• http://api.roblox.com/Marketplace/ProductInfo?assetId=1818

  {
      "AssetId": 1818,
      "ProductId": 1305046,
      "Name": "Crossroads",
      "Description": "The classic ROBLOX level is back!",
      "AssetTypeId": 9,
      "Creator": {
          "Id": 1,
          "Name": "ROBLOX"
      },
      "IconImageAssetId": 0,
      "Created": "2007-05-01T01:07:04.78Z",
      "Updated": "2017-09-26T22:43:21.667Z",
      "PriceInRobux": null,
      "Sales": 0,
      "IsNew": false,
      "IsForSale": false,
      "IsPublicDomain": false,
      "IsLimited": false,
      "IsLimitedUnique": false,
      "Remaining": null,
      "MinimumMembershipLevel": 0,
  "ContentRatingTypeId": 0
  }

Get an asset's AssetVersioNId

• http://www.roblox.com/studio/plugins/info?assetId=1818

Download various versions of an asset

• https://assetdelivery.roblox.com/v1/asset?id=1818
• https://assetdelivery.roblox.com/v1/asset?id=1818&version=1
• https://assetdelivery.roblox.com/v1/assetHash/b3c6b23ff18f48557b823ef5b72a0508

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

Useful Hacks

####Current User APIs

• /Game/GetCurrentUser.ashx
• /MobileAPI/UserInfo

Login APIs

POST https://www.roblox.com/Services/Secure/LoginService.asmx/ValidateLogin HTTP/1.1
Host: www.roblox.com
Content-Length: 85
Content-Type: application/json

{"userName":"","password":"","isCaptchaOn":false,"challenge":"","captchaResponse":""}

####Main Site

• www.roblox.com

• /Game/Tools/InsertAsset.ashx?nsets=10&type=base

• /Game/Tools/InsertAsset.ashx?type=user&userId=261&nsets=20

• /Game/Tools/InsertAsset.ashx?sid=-7

• /Login/Negotiate.ashx?suggest=

• /MobileAPI/Check-App-Version?appVersion=AppiOSV2.112.35972

• setup.roblox.com

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

• api.roblox.com

• /Game/GetAllowedExperimentalFeatures?placeId=1818

• clientsettings.api.roblox.com

• /Setting/QuietGet/ClientAppSettings

• /Setting/QuietGet/ClientSharedSettings

• /Setting/QuietGet/iOSAppSettings

• /Setting/QuietGet/WindowsAppSettings

• /Setting/QuietGet/WindowsBootstrapperSettings

• /Setting/QuietGet/WindowsStudioBootstrapperSettings