Skip to main content

​
Get Player Info

Get detailed information about a Roblox player.

​
Endpoint

GET /api/roblox/{username}

​
Path Parameters

​
username
string
required
Roblox username

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/roblox/Builderman" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "id": 156,
  "name": "builderman",
  "displayName": "builderman",
  "created": "2006-03-08T17:17:52.9Z",
  "hasVerifiedBadge": true,
  "avatar": "https://tr.rbxcdn.com/30DAY-Avatar-882C70E071E5997E51F8CB373002AFC3-Png/720/720/Avatar/Png/noFilter",
  "followers": 71254258,
  "friends": 0,
  "presence": "Offline",
  "items": 47,
  "rap": 14652368,
  "value": 18999762
}

​
Response Fields

​
id
number
Unique Roblox user ID
​
name
string
Roblox username
​
displayName
string
Display name shown on profile
​
created
string
Account creation date (ISO 8601 format)
​
hasVerifiedBadge
boolean
Whether the account has a verified badge
​
avatar
string
URL to the player’s avatar image (720x720)
​
followers
number
Number of followers
​
friends
number
Number of friends
​
presence
string
Current online status (e.g., “Online”, “Offline”)
​
items
number
Total number of items owned
​
rap
number
Recent Average Price (RAP) of player’s items
​
value
number
Total estimated value of player’s items

​
Get Player Outfits

Get a player’s saved outfits.

​
Endpoint

GET /api/roblox/{username}/outfits

​
Path Parameters

​
username
string
required
Roblox username

​
Example Request

curl -X GET "https://rocks.rive.wtf/api/roblox/Builderman/outfits" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "outfits": [
    {
      "id": 555869704325162,
      "name": "adidas Ice Angels",
      "isEditable": false,
      "outfitType": null
    },
    {
      "id": 17762785106,
      "name": "Winky",
      "isEditable": false,
      "outfitType": null
    },
    {
      "id": 11685920016,
      "name": "Check It",
      "isEditable": false,
      "outfitType": null
    }
  ]
}

​
Response Fields

​
outfits
array
Array of outfit objects
Player profiles must be public to retrieve information. Private profiles will return limited data or errors.
The RAP (Recent Average Price) and value fields are useful for tracking the worth of a player’s inventory over time.

​
Use Cases

Profile Lookup

Display player statistics and info

Trading Tools

Track item values and RAP

Outfit Browser

Browse and display player outfits

Analytics

Track follower growth and stats

​
Additional Notes

​
Account Age Calculation

The created field is in ISO 8601 format. Calculate account age: 
const created = new Date(data.created);
const now = new Date();
const ageInDays = Math.floor((now - created) / (1000 * 60 * 60 * 24));
const ageInYears = (ageInDays / 365).toFixed(1);

​
Value vs RAP

  • RAP (Recent Average Price): Average of recent item sales
  • Value: Estimated total worth of all items

​
Presence Status

Common presence values:
  • "Online" - Currently online
  • "Offline" - Not online
  • "In Game" - Playing a game
  • "In Studio" - Using Roblox Studio