Skip to main content
GET
/
agencies
/
insights
/
chatter-leaderboard
Get chatter leaderboard
curl --request GET \
  --url https://api.example.com/agencies/insights/chatter-leaderboard \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "chatterUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "chatterName": "Top Performer",
      "avatarUrl": "https://cdn.example.com/avatars/a1b2c3d4.jpg",
      "messages": 1240,
      "ppvsSent": 86,
      "ppvsUnlocked": 41,
      "revenue": 124500,
      "goldenRatio": 0.033,
      "unlockRatio": 0.477,
      "activeHours": 38.5,
      "eph": 3233,
      "avgResponseMs": 45200
    },
    {
      "chatterUuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "chatterName": "Rookie",
      "avatarUrl": null,
      "messages": 320,
      "ppvsSent": 12,
      "ppvsUnlocked": 3,
      "revenue": 6000,
      "goldenRatio": 0.009,
      "unlockRatio": 0.25,
      "activeHours": 8,
      "eph": 750,
      "avgResponseMs": null
    }
  ]
}
Required scope
  • read:agency — Read agency information, including the agency’s team members.

Authorizations

​
Authorization
string
header
required

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

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Query Parameters

​
startDate
string<date-time>

Start date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-20T00:00:00+01:00 or 2024-10-20T00:00:00Z). Stats are aggregated by UTC day.

​
endDate
string<date-time>

End date as ISO 8601 datetime string with optional timezone offset (e.g., 2024-10-25T00:00:00+01:00 or 2024-10-25T00:00:00Z). Stats are aggregated by UTC day.

​
chatterUuids
string

Comma-separated chatter UUIDs to filter by (max 100). Defaults to all chatters in the agency.

Response

Chatter leaderboard data

​
data
object[]
required