API Documentation – rblx-user-info-fetcher

Getting Started

This API combines multiple Roblox endpoints into a single call. Just send a POST request with a username or user ID, and optionally ask for extra data (avatar, presence, friend counts, etc.).

Base URL:

https://rbx-group-fetcher.dimasuperotovorot3000.workers.dev/

Request Parameters

Send a POST with Content-Type: application/json (or form‑encoded). The following fields are supported:

Parameter	Type	Description	Default
username	string	Roblox username (optional if `userId` is given)	-
userId	number	Roblox user ID (optional if `username` is given)	-
groupId	number	If provided, the response will include a `requestedGroup` field showing the user's role in that specific group.	-
includeAvatar	boolean	Include the user's avatar headshot URL.	`false`
includePresence	boolean	Include current presence (game, location, etc.).	`false`
includeFriendsCount	boolean	Include the number of friends.	`false`
includeFollowersCount	boolean	Include the number of followers.	`false`
includeFollowingCount	boolean	Include the number of followings.	`false`
includeGroups	boolean	Include the user's group memberships (detailed list).	`true`

Boolean handling: All include* flags accept:
✅ True: true, "true", "1", "on", any non‑zero number.
❌ False: false, "false", "0", "off", null, undefined.

Response Format

The JSON response always contains these base fields:

id – user ID
username – current username
displayName – display name
created – account creation timestamp (ISO 8601)
profileUrl – direct link to the user's profile
description – (only if the user has one)

Optional fields appear only if requested (and if data is available):

Field	Type	Description
groups	array	List of groups the user belongs to (each with `groupId`, `groupName`, `roleName`, `rank`, `isPrimary`, etc.)
requestedGroup	object	If `groupId` was sent, this contains the user's role in that specific group (or `null` if not a member).
avatarUrl	string	Headshot image URL (720x720 PNG).
presence	object	Presence info: `userPresenceType` (0=offline, 1=online, 2=in‑game, 3=studio), `lastLocation`, `placeId`, `gameId`, etc.
friendsCount	number	Total friends count.
followersCount	number	Total followers count.
followingCount	number	Total followings count.

Example Request

Using curl:

curl -X POST https://rbx-group-fetcher.dimasuperotovorot3000.workers.dev/ \
  -H "Content-Type: application/json" \
  -d '{"username": "PapaAleks11", "includeAvatar": true, "includePresence": true}'

Using JavaScript (fetch):

fetch('https://rbx-group-fetcher.dimasuperotovorot3000.workers.dev/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ username: 'PapaAleks11', includeAvatar: true })
})
  .then(res => res.json())
  .then(data => console.log(data));

🔽 Click to see example response (truncated)

{
  "id": 1478795848,
  "username": "PapaAleks11",
  "displayName": "Dima",
  "created": "2020-02-27T07:16:28.267Z",
  "profileUrl": "https://www.roblox.com/users/1478795848/profile",
  "description": "oh hi!",
  "avatarUrl": "https://...",
  "presence": {
    "userPresenceType": 2,
    "lastLocation": "Game",
    "placeId": 123456789,
    "gameId": "..."
  },
  "groups": [
    {
      "groupId": 4914494,
      "groupName": "Paradoxum Games",
      "memberCount": 5742975,
      "roleId": 32808020,
      "roleName": "Player",
      "rank": 1
    }
    // ... many more
  ]
}

Error Responses

The API returns standard HTTP status codes:

Code	Meaning
400	Missing `username`/`userId`, unsupported content type, or invalid parameters.
404	Username not found on Roblox.
405	Request method not allowed (only POST is accepted).
500+	Internal worker error (rare – check the error message).

Error responses always contain a JSON object with an error field, and sometimes detail.

Notes

If you open the API URL directly in a browser, you'll be redirected to this site.
Please be reasonable with request frequency to avoid hitting Roblox rate limits.
The source code is available on GitHub under the MIT License.

API Reference