FAfanvue

Get earnings percentile

Returns the earnings percentile bucket the authenticated creator falls into based on their gross earnings over the last 30 days.

The value is a decimal percentile where lower numbers indicate higher rank (e.g. 0.01 means top 0.01% of earners, 99.50 is near the bottom). Buckets are derived from a periodic snapshot of platform-wide earnings, not a live recomputation, and may take any decimal value the snapshot exposes — not just whole numbers.

get/insights/earnings/percentile

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/insights/earnings/percentile
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:insights

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Earnings percentile for the authenticated creator

percentilenumber required

Earnings percentile (decimal) the creator falls into based on their gross earnings over the last 30 days. Lower values indicate higher rank: 0.01 = top 0.01% of earners, 99.50 ≈ bottom. Values are not constrained to whole numbers — bucket granularity is determined by the lookup table.

Changes

No recorded changes to this operation across all 8 revisions of this API.