FAfanvue

Get chatter leaderboard

Returns per-chatter performance metrics for the authenticated user's agency over a specified time period.

Each row includes message volume, PPV sends and unlocks, revenue, derived ratios (golden ratio, unlock ratio), active hours, earnings per active hour, and average response time. Rows are sorted by revenue descending.

Historical stats are precomputed daily and the current UTC day is included live at read time. Performance metrics (messages, PPV sends and unlocks, ratios, active hours, response time) are attributed to the day the content was sent. Revenue is attributed to the day of purchase, and earnings per active hour divides that purchase-date revenue by send-date active hours. <Info>Requires: Agency admin access</Info>

get/agencies/insights/chatter-leaderboard

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/agencies/insights/chatter-leaderboard
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:agency

Query parameters

startDatestring 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.

endDatestring 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.

chatterUuidsstring

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

Headers

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

API version to use for the request

Response

Chatter leaderboard data

Changes

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