curl --request GET \
--url https://api.fanvue.com/v1/insights/earnings/percentile \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/insights/earnings/percentile"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/insights/earnings/percentile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"percentile": 12.5
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}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.
curl --request GET \
--url https://api.fanvue.com/v1/insights/earnings/percentile \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/insights/earnings/percentile"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/insights/earnings/percentile', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"percentile": 12.5
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}read:insights— Access analytics, metrics, and insights data for performance tracking.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
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.
Was this page helpful?