GET /v1/stats/leaderboard

Pro+

Retrieve a leaderboard of top voters ranked by vote count within a specified time period. This endpoint allows you to identify your most active community members, recognize loyal voters, and build gamification features around voting. The leaderboard can be filtered by date range, provider, and result limit, making it flexible for different use cases such as monthly competitions, provider-specific rankings, or all-time top voters. Use this endpoint to display leaderboards on your website, reward top voters, or analyze voting engagement patterns. Available on Pro+ plans.

Request

http

GET https://api.votepipe.com/v1/stats/leaderboard?days=30&limit=10
Authorization: Bearer mr_live_your_api_key_here

Query Parameters

Parameter	Type	Required	Description
days	integer	No	Number of days to look back (default: 30)
limit	integer	No	Number of results (default: 10, max: 100)
provider	string	No	Filter by provider key

Response (200 OK)

json

{
  "data": {
    "voters": [
      {
        "name": "PlayerOne",
        "votes": 28,
        "last_vote": "2026-01-02T12:00:00Z"
      },
      {
        "name": "GamerX",
        "votes": 25,
        "last_vote": "2026-01-02T11:30:00Z"
      }
    ]
  }
}

Learn More

→ Statistics Endpoints → GET /v1/stats/voter/:voter_name