Angelz API

Every API key is tied to one IP. To apply for a key, DM southctrl on Discord.

Use the endpoint path below, replace the required params, and send Authorization: Bearer YOUR_API_KEY.

Quick Start

Choose a username

Use the Angelz.bio username you want.

Call the profile route

Send a request to /api/angelz/profile?username=....

Read the profile data

response includes profile info, links, audio, badges, and styling data.

Best for profile lookup tools, user cards, and bio viewers.

Overview

Angelz API allows you to fetch complete profile data from Angelz.bio by username. response includes profile appearance, social platform integrations, audio tracks, badges, and more.

Get Profile

Retrieve a full Angelz.bio profile.

Endpoint

GET /api/angelz/profile

Query Parameters

username

string

required

Angelz.bio username. Case-insensitive.

Example Request

curl "https://rocks.rive.wtf/api/angelz/profile?username=southctrl" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "uid": 13,
  "username": "southctrl",
  "alias": "prison",
  "display_name": "southctrl",
  "bio": "",
  "avatar": "https://cdn.angelz.bio/avatars/edc539d0-df0b-46e0-97fc-61c99f6983fb.png",
  "background": "",
  "page_bg": "https://cdn.angelz.bio/page-bgs/411e9ecc-a0e4-453e-810e-5d51fcb12220.mp4",
  "location": "Miami, Florida",
  "views": 10,
  "discord_id": "1252001166703853588",
  "audios": [
    {
      "id": "ec82bd5c-2cba-4975-8e92-06563f412b88",
      "title": "Miami",
      "artist": "",
      "audio_url": "https://cdn.angelz.bio/audios/5b858b99-261a-4483-aa62-165e603e4395.mp3",
      "cover_url": "",
      "is_active": 1
    }
  ],
  "links": [],
  "custom_badges": "[\"custom-image:{\\\"url\\\":\\\"https://cdn.angelz.bio/custom-badges/70e6806c-c775-4f3d-ac67-0cb81f84e9bd.webp\\\",\\\"name\\\":\\\"rive\\\"}\",\"OG\"]",
  "hidden_badges": "",
  "profile_effect": "{\"avatarRoundness\":50,\"equippedDecorationPath\":\"\",\"equippedDecorationUrl\":\"\",\"borderGlowSize\":2,\"borderGlowSpeed\":4,\"customCursorUrl\":\"\"}",
  "accent_color": "#f6f6f6",
  "glow_color": "#ffffff",
  "card_width": 358,
  "card_radius": 40,
  "card_opacity": 100,
  "card_layout": "horizontal",
  "widget_layout": "3x3",
  "name_effect": "typing",
  "name_font_size": 20,
  "name_color": "#000000",
  "name_align": "center",
  "bio_font_size": 8,
  "bio_color": "",
  "bio_align": "center",
  "typing_speed": 3.5,
  "border_glow": 1,
  "glass_effect": 1,
  "tilt_effect": 1,
  "show_views": 1,
  "show_location": 1,
  "audio_enabled": 1,
  "audio_shuffle": 0,
  "audio_player": 0,
  "audio_corner": 0,
  "font_style": "",
  "enter_text": "",
  "tooltip_color": "",
  "tooltip_font": "Comic Neue",
  "tooltip_effect": "glow",
  "tooltip_text_color": "",
  "tooltip_gradient_color": "",
  "integration_order": "[]",
  "discord_enabled": 1,
  "spotify_enabled": 1,
  "github_username": "southctrl",
  "github_enabled": 0,
  "roblox_username": "exaudity",
  "roblox_enabled": 1,
  "lastfm_username": "ctrltokyolol",
  "lastfm_enabled": 0,
  "steam_username": "southctrl",
  "steam_enabled": 0
}

Response Fields

Identity

Field	Type	Description
`uid`	`integer`	Unique numeric user ID
`username`	`string`	Angelz.bio username
`alias`	`string`	Profile alias (alternative slug)
`display_name`	`string`	Name shown on the profile card
`bio`	`string`	Profile bio text
`location`	`string`	User-set location string
`views`	`integer`	Total profile view count

Media

Field	Type	Description
`avatar`	`string`	CDN URL for the profile avatar image
`background`	`string`	Background image URL (if set)
`page_bg`	`string`	Full-page background URL — can be image or `.mp4` video

Card Appearance

Field	Type	Description
`card_width`	`integer`	Profile card width in pixels
`card_radius`	`integer`	Card border radius
`card_opacity`	`integer`	Card background opacity (0–100)
`card_layout`	`string`	Layout style — `horizontal` or `vertical`
`widget_layout`	`string`	Widget grid size, e.g. `3x3`
`accent_color`	`string`	Hex accent color
`glow_color`	`string`	Hex border glow color
`border_glow`	`integer`	Border glow enabled (`1`) or disabled (`0`)
`glass_effect`	`integer`	Glass/frosted effect enabled (`1`) or disabled (`0`)
`tilt_effect`	`integer`	Tilt-on-hover effect enabled (`1`) or disabled (`0`)
`font_style`	`string`	Custom font style (if set)

Name & Bio

Field	Type	Description
`name_effect`	`string`	Animation effect on name — e.g. `typing`, `none`
`name_font_size`	`integer`	Name font size in px
`name_color`	`string`	Hex color for name text
`name_align`	`string`	Text alignment — `left`, `center`, `right`
`typing_speed`	`float`	Speed multiplier for the typing animation
`enter_text`	`string`	Text shown on profile enter screen (if set)
`bio_font_size`	`integer`	Bio text font size in px
`bio_color`	`string`	Hex color for bio text
`bio_align`	`string`	Bio text alignment — `left`, `center`, `right`

Field	Type	Description
`tooltip_color`	`string`	Tooltip background hex color
`tooltip_font`	`string`	Tooltip font family (e.g. `Comic Neue`)
`tooltip_effect`	`string`	Tooltip animation effect (e.g. `glow`)
`tooltip_text_color`	`string`	Tooltip text hex color
`tooltip_gradient_color`	`string`	Tooltip gradient hex color (if set)

Visibility

Field	Type	Description
`show_views`	`integer`	Show view count on profile (`1`/`0`)
`show_location`	`integer`	Show location on profile (`1`/`0`)

Audio

Field	Type	Description
`audio_enabled`	`integer`	Audio player enabled (`1`/`0`)
`audio_shuffle`	`integer`	Shuffle mode enabled (`1`/`0`)
`audio_player`	`integer`	Show visible player UI (`1`/`0`)
`audio_corner`	`integer`	Corner-pinned player (`1`/`0`)
`audios`	`array`	List of audio track objects (see below)

Audio Object

Field	Type	Description
`id`	`string`	Unique track UUID
`title`	`string`	Track title
`artist`	`string`	Artist name
`audio_url`	`string`	CDN URL for the `.mp3` file
`cover_url`	`string`	Cover art URL (if set)
`is_active`	`integer`	Whether this track is currently active

Badges & Effects

Field	Type	Description
`custom_badges`	`string`	JSON-encoded array of badge definitions
`hidden_badges`	`string`	JSON-encoded array of hidden badge IDs
`profile_effect`	`string`	JSON-encoded object with avatar/decoration settings
`integration_order`	`string`	JSON-encoded array defining social icon display order

`profile_effect` Object (parsed)

{
  "avatarRoundness": 50,
  "equippedDecorationPath": "",
  "equippedDecorationUrl": "",
  "borderGlowSize": 2,
  "borderGlowSpeed": 4,
  "customCursorUrl": ""
}

Links

Field	Type	Description
`links`	`array`	Array of custom link objects added to the profile

Discord

Field	Type	Description
`discord_id`	`string`	Linked Discord user ID (snowflake)
`discord_enabled`	`integer`	Discord widget shown (`1`/`0`)
`discord_server_invite`	`string`	Discord server invite code (if set)
`discord_server_enabled`	`integer`	Discord server widget shown (`1`/`0`)

Every supported platform exposes two fields following a consistent pattern:

Pattern	Type	Description
`{platform}_username`	`string`	username on that platform
`{platform}_enabled`	`integer`	Whether the icon is shown on the profile (`1`/`0`)

Supported Platforms

Platform	Username Field	Enabled Field
GitHub	`github_username`	`github_enabled`
Steam	`steam_username`	`steam_enabled`
Roblox	`roblox_username`	`roblox_enabled`
Last.fm	`lastfm_username`	`lastfm_enabled`
Twitter / X	`twitter_username`	`twitter_enabled`
Instagram	`instagram_username`	`instagram_enabled`
TikTok	`tiktok_username`	`tiktok_enabled`
YouTube	`youtube_url`	`youtube_enabled`
Twitch	`twitch_username`	`twitch_enabled`
Spotify	(Discord-linked)	`spotify_enabled`
Telegram	`telegram_username`	`telegram_enabled`
Reddit	`reddit_username`	`reddit_enabled`
Pinterest	`pinterest_username`	`pinterest_enabled`
LinkedIn	`linkedin_username`	`linkedin_enabled`
Kick	`kick_username`	`kick_enabled`
Bluesky	`bluesky_username`	`bluesky_enabled`
Mastodon	`mastodon_username`	`mastodon_enabled`
Threads	`threads_username`	`threads_enabled`
Medium	`medium_username`	`medium_enabled`
Dribbble	`dribbble_username`	`dribbble_enabled`
Behance	`behance_username`	`behance_enabled`
Figma	`figma_username`	`figma_enabled`
osu!	`osu_username`	`osu_enabled`
Minecraft	`minecraft_username`	`minecraft_enabled`
Valorant	`valorant_username`	`valorant_enabled`
AniList	`anilist_username`	`anilist_enabled`
MyAnimeList	`myanimelist_username`	`myanimelist_enabled`
Letterboxd	`letterboxd_username`	`letterboxd_enabled`
SoundCloud	`soundcloud_username`	`soundcloud_enabled`
Ko-fi	`kofi_username`	`kofi_enabled`
Patreon	`patreon_username`	`patreon_enabled`
PayPal	`paypal_username`	`paypal_enabled`
Cash App	`cashapp_username`	`cashapp_enabled`
WhatsApp	`whatsapp_username`	`whatsapp_enabled`

A platform with _enabled: 0 will not display on the profile even if a username is set. A platform with _enabled: 1 but an empty username string will also not display.

Error Responses

Status	Code	Description
`404`	`not_found`	Username does not exist on Angelz.bio
`401`	`unauthorized`	Missing or invalid API key
`500`	`internal_error`	Server-side error

{
  "code": "not_found",
  "status": 404
}

Getting Started

Social Media

Developer

Gaming

Sports

Entertainment

Profiles & Lookup

Crypto & Finance

Utilities

Quick Start

Overview

Get Profile

Endpoint

Query Parameters

Example Request

Example Response

Response Fields

Identity

Media

Card Appearance

Name & Bio

Tooltip

Visibility

Audio

Audio Object

Badges & Effects

`profile_effect` Object (parsed)

Links

Discord

Supported Platforms

Error Responses

Getting Started

Social Media

Developer

Gaming

Sports

Entertainment

Profiles & Lookup

Crypto & Finance

Utilities

Documentation Index

​Quick Start

​Overview

​Get Profile

​Endpoint

​Query Parameters

​Example Request

​Example Response

​Response Fields

​Identity

​Media

​Card Appearance

​Name & Bio

​Tooltip

​Visibility

​Audio

​Audio Object

​Badges & Effects

​profile_effect Object (parsed)

​Links

​Discord

​Social Platform Fields

​Supported Platforms

​Error Responses

Quick Start

Overview

Get Profile

Endpoint

Query Parameters

Example Request

Example Response

Response Fields

Identity

Media

Card Appearance

Name & Bio

Tooltip

Visibility

Audio

Audio Object

Badges & Effects

`profile_effect` Object (parsed)

Links

Discord

Social Platform Fields

Supported Platforms

Error Responses