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.
Scope required: read:insights
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
API version to use for the request
"2025-06-26"
Response
Earnings percentile for the authenticated creator
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.