API Documentation – rblx-user-info-fetcher

Documentation Sections

Changelog

See the version history and updates.

FAQ

Common questions and troubleshooting.

SDK Examples

Code snippets in various languages.

Rate Limits

Best practices and rate limit info.

Contributing

How to contribute to the project.

License

MIT License details.

Playground

Test the API live.

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.