Roblox Asset API Documentation

This project is open source and you can find the code on Forgejo.

We do not store any personal information. We only log a timestamp, IP address, HTTP method, and path for debugging and spam monitoring purposes. These logs are shown in the console and cleared daily.

We have a Discord Bot! You can add it to your server or user here! You can join the KCA Discord here!

Request Format

The request must be sent as JSON with the following format:

{
    "type": "batching",
    "data": [
        "assetId1",
        "assetId2",
        ...
    ],
    "cookie": "optional-roblosecurity-cookie"
}
    

Parameters:

• type: The type of the request. Must be "batching".
• data: An array of asset IDs that you want to request.
• cookie: Optional. A .ROBLOSECURITY cookie. If not provided, you will only be able to access public assets. The cookie is used once to make the request to Roblox servers and is then discarded permanently. You can find more information on obtaining your cookie here!

Rate Limit

There is a limit of 25 requests per minute. If this limit is exceeded, the following error will be returned:

{
	"code": 429,
	"error": "Rate limit exceeded",
	"status": "error"
}
		

Response Format

The response will be in JSON format:

{
	"type": "batching-response",
	"data": {
		"assetId1": {
			"status": "success",
			"url": "location_of_asset",
		},
		"assetId2": {
			"status": "failure",
			"code": error_code,
			"message": "error_message",
			"additional": "additional_information"
		}
	}
}

	

Fields:

• type: Always "batching-response".
• data: An object where each key is an asset ID and the value contains the result of the request.
• status: Either "success" or "failure".
• url: The location of the asset if the request was successful, or an empty string if it failed.
• additional: Any additional information, such as error messages.

Example Request

POST /
Content-Type: application/json

{
	"type": "batching",
	"data": [
		"1837070127",
		"1842241530",
		"1838857104",
		"123412341234",
		"114870793726467"
	]
}
    

Example Response

{
	"type": "batching-response",
	"data": {
		"1837070127": {
			"status": "success",
			"url": "https://c6.rbxcdn.com/bfe94941622e26b7a7553ebd31cdbbd4"
		},
		"1838857104": {
			"status": "success",
			"url": "https://c4.rbxcdn.com/fa7eef8201e25978df17cccc955849b8"
		},
		"1842241530": {
			"status": "success",
			"url": "https://c1.rbxcdn.com/d12b63528d0039017313f0ee8eeb2f88"
		},
		"123412341234": {
			"status": "failure",
			"code": 404,
			"message": "Not Found",
			"additional": "The requested page could not be found but may be available again in the future."
		},
		"114870793726467": {
			"status": "failure",
			"code": 403,
			"message": "Forbidden",
			"additional": "The request was a legal request, but the server is refusing to respond to it."
		}
	}
}