place_ids = [1818]
places_response = rbx_request("GET", "https://games.roblox.com/v1/games/multiget-place-details", params={
"placeIds": place_ids
})
places_data = places_response.json()
print(places_data)
for place_data in places_data:
print("ID:", place_data["placeId"])
print("Name:", place_data["name"])
print("Description:")
print(place_data["description"])
print("URL:", place_data["url"])
print("Builder Name:", place_data["builder"])
print("Builder ID:", place_data["builderId"])
print("Playable:", place_data["isPlayable"] and "Yes" or "No")
if not place_data["isPlayable"]:
print("Reason:", place_data["reasonProhibited"])
print("Universe ID:", place_data["universeId"])
print("Universe Root Place ID:", place_data["universeRootPlaceId"])
print("Price:", place_data["price"] or "Free")
print("Image Token:", place_data["imageToken"])
Places
Places are a kind of Asset that represents a single "world" in a game universe and contain a DataModel (the Luau global game
). Places must be attached to a parent universe to function.
Getting place information
To get place information, use the https://games.roblox.com/v1/games/multiget-place-details?placeIds=PLACEIDS
endpoint. It supports multiple place IDs by passing the parameter multiple times: ?placeIds=1818&placeIds=1819
.ROBLOSECURITY
cookie to use this endpoint.[
{
"placeId": 1818,
"name": "Classic: Crossroads",
"description": "The classic ROBLOX level is back!",
"url": "https://www.roblox.com/games/1818/Classic-Crossroads",
"builder": "Roblox",
"builderId": 1,
"isPlayable": true,
"reasonProhibited": "None",
"universeId": 13058,
"universeRootPlaceId": 1818,
"price": 0,
"imageToken": "T_1818_b1a2"
}
]
Field Name | Type | Explanation |
---|---|---|
placeId | int | The place ID. |
name | str | The place's name. |
description | str | The place's description. |
url | str | A URL that will bring the user to this place's webpage. |
builder | str | The name of the game's creator. Might be a user name or a group name. |
builderId | int | The ID of the game's creator. Might be a user ID or a group ID. |
isPlayable | bool | Whether the game is playable by the authenticated user. |
reasonProhibited | str | If isPlayable is false, explains why the game isn't playable.
|
universeId | int | The universe ID this place is inside of. |
universeRootPlaceId | int | The parent universe's root place. |
price | int | The game's price in Robux. |
imageToken | str | A redeemable token that can be used to generate game thumbnails. Deprecated
|
Do note that, as places are a type of Asset, all information on the Assets page is completely valid here. If the data above isn't enough - for example, if you need to actually know if the place owner is a group or a user, just treat the place ID as an asset ID and use any of the asset details endpoints.
Here's an example of a function that gets place information, using the request function seen at X-CSRF-Token#Request_function - you'll need that code somewhere in your file before this code!