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

Request

Base URL
https://api.grove.city (the document declares no server; this is the origin it was published from)
URL
https://api.grove.city/v1/profiles/{handle}/full
Auth
none declared

handlestring required

User handle (case-insensitive)

enrichboolean

Include content metadata (title, description, thumbnail).

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

Time window for leaderboard rank.

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.

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

No recorded changes to this operation across all 1 revision of this API.