roblox-web-apis icon indicating copy to clipboard operation
roblox-web-apis copied to clipboard

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

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

Login APIs

Negotiation API

Setup APIs

Mobile version check

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

Downloads and version endpoints