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

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.