v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
profiles

Get full public profile (consolidated)

Get all public profile data in a single request.

Combines profile metadata, stats, earning addresses, social links, supporters, top content, leaderboard rank, and active giveaways.

Replaces the need for 5+ separate API calls per profile page load, reducing database connection usage from 5-12 to 1-2 connections.

This is a public endpoint - no authentication required.

get/v1/profiles/{handle}/full

Path parameters

handlestring required

User handle (case-insensitive)

User handle (case-insensitive)

Query parameters

enrichboolean

Include content metadata (title, description, thumbnail).

Include content metadata (title, description, thumbnail).

window'24h' | '7d' | '30d' | 'all'

Time window for leaderboard rank.

Time window for leaderboard rank.

Response

Successful Response

handlestring required

User's handle (e.g., 'alice')

descriptionstring nullable

Profile bio (max 280 characters)

avatar_urlstring nullable

User-selected avatar URL

created_atstring required

Account creation date (ISO 8601)

referral_codestring nullable

User's shareable referral code

tip_to_talk_minnumber nullable

Minimum tip in USD for paid messages (Tip to Talk). NULL = disabled.

is_claimedboolean

Whether this profile has been claimed by the creator. Pre-registered profiles are unclaimed until the creator authenticates.

tip_button_labelstring

CTA label for the tip button on the profile page. Feed/content contexts should always show 'Tip' regardless.

Example response

{
  "theme": {
    "accent_color": "#4CAF50",
    "preset": "dark"
  }
}