Roblox API endpoint
Returns one cursor-paginated page of public badge metadata for a Roblox experience. Pass next_cursor back unchanged as cursor. No user-awarded badge data is returned.
/roblox/badgesQuery parameters:
universe_id (required): positive public Roblox experience universe ID.cursor (optional): opaque cursor returned as next_cursor from a prior response.Returns one cursor-paginated page of public badge metadata and icons for an experience. It does not expose which users earned a badge.
| Field | Filled in, of 7 checked | Values in the sample |
|---|---|---|
| id | 7 | |
| name | 7 | |
| description | 7 | |
| enabled | 7 | true in 7 of 7 |
| created_at | 7 | 2018-10-17 |
| updated_at | 7 | 2018-10-17 to 2022-01-06 |
| awards_all_time | 7 | 1,558,819 to 22,702,732, median 9,100,376 |
| awards_past_day | 7 | 105 to 1,035, median 417 |
| icon_url | 7 | tr.rbxcdn.com |
| awarding_universe_id | 7 | |
| awarding_universe | 7 | |
| awarding_root_place_id | 7 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| universe_id | integer | Yes | Positive Roblox universe id Minimum: 1. | 383310974 | |
| cursor | string | No | Opaque cursor returned by a previous response | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/roblox/badges?universe_id=383310974" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"universe_id": 383310974,
"badges": [
{
"id": 2124439922,
"name": "Tiny Isles",
"enabled": true,
"awards_all_time": 1549117
}
]
}
}Request schema
No body schema
Response schema
#/definitions/roblox.badgesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | roblox.BadgesResponse | No | ||||
| data.badges | array | No | ||||
| data.badges[].awarding_root_place_id | integer | No | ||||
| data.badges[].awarding_universe | string | No | ||||
| data.badges[].awarding_universe_id | integer | No | ||||
| data.badges[].awards_all_time | integer | No | ||||
| data.badges[].awards_past_day | integer | No | ||||
| data.badges[].created_at | string | No | ||||
| data.badges[].description | string | No | ||||
| data.badges[].enabled | boolean | No | ||||
| data.badges[].icon_url | string | No | ||||
| data.badges[].id | integer | No | ||||
| data.badges[].name | string | No | ||||
| data.badges[].updated_at | string | No | ||||
| data.next_cursor | string | No | ||||
| data.previous_cursor | string | No | ||||
| data.universe_id | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/roblox/badges?universe_id=383310974" \
-H "x-api-key: $CRAWLORA_API_KEY"