[Action Needed] Sunsetting api.roblox.com

[Iron_Legion]

Hi developers,

In order to increase the reliability of our platform and improve scalability, we are migrating endpoints away from the monolithic api.roblox.com web API.

Beginning on July 15, 2022, we will start removing individual API endpoints from api.roblox.com. All endpoints are scheduled to be removed by the end of the year.

We recommend switching to newer endpoints on the apis.roblox.com or individual APIs (avatar.roblox.com, games.roblox.com, etc).

Please update any tools, browser plugins, or third-party sites that rely on api.roblox.com over to the newer endpoints listed below.

If you are having any issues with the new endpoints, reply to this post and we will be happy to provide answers.

---

FAQs

What is the exact date each API endpoint will be removed?

• Individual endpoints will be removed one-by-one at some point between now and the end of the year. We don’t have an exact date for each one.

I am not a web developer, how can I tell if this impacts me?

• This change only impacts developers who are making requests from third-party servers, browser plugins, or tools to api.roblox.com.
• If you only develop inside of the Roblox game engine, you don’t need to make any changes.
• Currently HttpService does not allow direct requests to *.roblox.com. Some developers use proxy web servers to get around this limitation. If you use one of these proxy servers, you may be affected.

The new recommended endpoint doesn’t solve my use case, what can I do?

• Please reply to this post and we will do our best to assist you.

The new recommended endpoint is rate limiting me with a 429 Status Code (Too Many Requests)

• Different endpoints may have different rate limits applied. Reply with information about your use case and how frequently you are hitting the endpoint, and we will try to help you.

Is there a better way to notify people who are still using API endpoints?

• As part of the Open Cloud initiative, we are allowing consumers to identify themselves using API keys. In the future, this will allow us to notify impacted developers before we sunset any API endpoints.

What is apis.roblox.com and how is it different from api.roblox.com?

• apis.roblox.com is Roblox’s API Gateway and is responsible for routing traffic to services containing our API endpoints. Long-term we plan to move most of our endpoints to apis.roblox.com.
• api.roblox.com is a single monolithic site that handles traffic directly. The lack of routing has lead to an increasing number of scalability and reliability issues over time.

How can I view the documentation for endpoints on apis.roblox.com?

• As part of the Open Cloud initiative, we plan to create a unified documentation system for our web API endpoints. For now, you can visit Open Cloud to view some of the endpoints.

---

Endpoints

This section is a list of all the public api.roblox.com endpoints, and the replacement endpoints that we recommend switching over to. The new endpoints have different request and response formats, so we recommend reading the documentation.

Users

GET /users/account-info

→ Users Api for user info

→ AccountSettings Api for email info

→ https://economy.roblox.com/docs#!/Currency/get_v1_user_currency for Robux balance

→ Locale Api for locale info

GET /users/{userId}

→ Users Api for user info

→ https://thumbnails.roblox.com/docs#!/Avatar/get_v1_users_avatar for thumbnail

GET /users/get-by-username

→ Users Api

Blocking

GET /userblock/getblockedusers

→ AccountSettings Api

POST /userblock/block

→ AccountSettings Api

POST /userblock/unblock

→ AccountSettings Api

Marketplace

GET /marketplace/productinfo

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

GET /marketplace/game-pass-product-info

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

GET /marketplace/productdetails

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

GET /developerproducts/list

→ Develop Api

GET /currency/balance

→ https://economy.roblox.com/docs#!/Currency/get_v1_user_currency

GET /my/balance

→ https://economy.roblox.com/docs#!/Currency/get_v1_user_currency

Universes

GET /universes/get-info

→ Games Api

GET /universes/get-universe-containing-place

→ Games Api

POST /universes/create

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

GET /universes/{universeId}/listcloudeditors

→ https://develop.roblox.com/docs#!/TeamCreate/get_v1_universes_universeId_teamcreate_memberships

GET /universes/get-universe-places

→ Develop Api

Assets

GET /ownership/hasasset

→ Inventory Api

GET /users/{userId}/canmanage/{assetId}

→ Develop Api

GET /assets/{id}/versions

→ Develop Api

GET /v2/assets/{id}/versions

→ Develop Api

Miscellaneous

GET /users/{userId}/onlinestatus

→ https://presence.roblox.com/docs#!/Presence/post_v1_presence_users

GET /users/{userId}/friends

→ Friends Api

GET /groups/{groupId}

→ Groups Api

GET /incoming-items/counts

→ Friends Api for friend request count

→ PrivateMessages Api for unread message count

GET /user/get-vote-count

→ https://api.roblox.com/user/get-vote-count?targetType=Place

[The_Potato97 (ThePotato)]

If you’re sunsetting /users/{userId}/onlinestatus you’re going to need to fix the presence API’s last online date currently it returns 10+ years for people last online a few hours ago

Related bug reports:

Inconsistent presence information across web API endpoints

Reproduction Steps Send a POST request (with X-CSRF-Token verification) to https://presence.roblox.com/v1/presence/users with the following body: { "userIds": [ 998796 ] } This bug only appears to occur for certain user IDs - I’ve tested a few here: User ID Legacy API date Presence API date 998796 2021-07-12T19:45:50.927-05:00 2008-09-06T00:16:31.08Z 2819985011 2022-01-21T14:13:02.307-06:00 2021-08-18T18:01:37.723Z 292222536 2022-01-18T17:32:49.447-06:00 2017-04-24T21:12:…

Weird presence api behaviour (LastOnline)

Hello! I have noticed weird https://presence.roblox.com api behaviour. Basically it returns very odd LastOnline values. For comparison: [image] I have tested that on user id 8641785 Legacy api: http://api.roblox.com/users/8641785/onlinestatus Presence api: https://presence.roblox.com/docs#!/Presence/post_v1_presence_users

[extramoose (danielle)]

Is there a general timeframe as to when the unreplaced endpoints will get their replacements? There are some pretty important ones in there (e.g. ProductInfo). There are also a lot of endpoints not mentioned in the OP. Will those get replacements?

[THULiCORE (Thuli)]

@Iron_Legion

In order to increase the reliability of our platform and improve scalability

If it improves the reliability that much to sunset such a major thing, it better stop Roblox going down every damn few days. I’d take that trade off.

@Iron_Legion

We don’t have an exact date for each one.

Can you provide at least some form of basic timetable? Even a per-month basis will be enough.

@Iron_Legion

apis.roblox.com is Roblox’s API Gateway and is responsible for routing traffic to services containing our API endpoints. Long-term we plan to move most of our endpoints to apis.roblox.com .

Is this wording meant to be like this? apis.roblox.com == apis.roblox.com. I don’t see why you’d move endpoints there if you’re sunsetting it.

I just hope that this will finally be the necessary action to many of Roblox’s server reliability issues. That’d be a great trade off. If so, next stop is to finally stop server DDoS attacks.

[LevelKipling (Level)]

Glad to see another legacy remnant of the site being sunsetted if it benefits Roblox in the long run.

As the others have mentioned though, some transparency/an estimated timeframe (if possible) for when the replacements of said decomissioned API endpoints will be ready would be nice so people relying on these endpoints know what to expect.

[Julli4n (Jullian)]

@Iron_Legion

GET /developerproducts/list

→ Develop Api

The new endpoint listed isn’t actually publicly documented yet, but regardless the endpoint still doesn’t return the productId necessary to update or fetch more data on a developer product. (see LegacyApi vs DevelopApi )

DevelopApi response:

[{"id":12973870,"name":"A","Description":null,"shopId":3564373403,"iconImageAssetId":null}]

id here is developerProductId

LegacyApi response:

{"DeveloperProducts":[{"ProductId":1265158464,"DeveloperProductId":12973870,"Name":"A","Description":null,"IconImageAssetId":null,"displayName":"A","displayDescription":null,"displayIcon":null,"PriceInRobux":null}],"FinalPage":true,"PageSize":50}

[ThatTimothy]

For APIs such as POST /universes/create, will they be removed before the new endpoint is added?

@Iron_Legion

POST /universes/create

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

It would make sense that they wait, and give appropriate time to switch over, but I wanted to make sure.

---

On another note, is there a reason there’s so many subdomains for Roblox’s API? If it internally routes to apis.roblox.com, why do we have so much subdomains such as games, users, presense, etc.? Why can’t those just be apis.roblox.com/games, apis.roblox.com/users, apis.roblox.com/presense?

[LifeDigger (SummerLife)]

@THULiCORE

I don’t see why you’d move endpoints there if you’re sunsetting it.

I think what they mean is that they where planning to move all the endpoints to “apis.roblox.com” but due to the issues they have just decided to not move everything over. Unless I miss read the post.

[LifeDigger (SummerLife)]

Sad to see the api.roblox.com go but if it was causing issues I guess this update will be good.

I really wanna see more api’s put on the open cloud cuz it is a pain in the ass using cookies and with the recent update where cookies will get invalidated on a different region is also annoying.

[local_ip (jmk)]

@THULiCORE

I don’t see why you’d move endpoints there if you’re sunsetting it.

api and apis are separate.

[Automationeer (Eleanor)]

How would you be able to remove an IP if you don’t know what you’re removing then?

[0xA2CAD3 (aiden)]

They could blur them and add a button to unblur them if you wanna view the IP

[Recurslve (Mothwa)]

I think he or she is implicating the idea that there should be a streamer mode or something?

[Master3395]

I hope they aren’t sunsetting the onlinestatus.
I use it a lot on discord
And the presence API is just broken, it’s been broken for years…

[KidThatHates_Roblox]

it should only show part of the ip, realistically you wouldnt have that many to begin with

also does it email you if a change is made to the api key/a new one is added?

[Julli4n (Jullian)]

@ThatTimothy

On another note, is there a reason there’s so many subdomains for Roblox’s API? If it internally routes to apis.roblox.com, why do we have so much subdomains such as games, users, presense, etc.? Why can’t those just be apis.roblox.com/games, apis.roblox.com/users, apis.roblox.com/presense?

They don’t internally route to ApiGateway. *.roblox.com API services (excluding apis, ecsv2), known as BEDEV1 services, use internal *.api.roblox.com endpoints. apis.roblox.com, ecsv2.roblox.com on the other hand, route to BEDEV2 services, part of a newer micro-service architecture. This blog post also has a brief mention of BEDEV2.

[boshjosh1918]

Why are HttpService requests to *.roblox.com blocked anyways?

[Usering]

Good riddance, I remember when api.roblox.com was introduced it was so cool. Glad you guys are actively expanding this!

@Iron_Legion

GET /marketplace/productinfo

→ A new endpoint is not ready at the time of this announcement. Please stay tuned.

It would be very unfortunate if this end point was not ready by July 15th. I still use it in my catalog scraper (which is responsible for updating the available catalog in Robloxian High School), and having no alternative will mean it will be non-functional.

[MineJulRBX_FS (MineJulRBX)]

So they don’t get DDoS’d by their own servers.