GET /v1/stats/by-provider

Growth+

Retrieve vote statistics grouped by provider for a specified date range. This endpoint returns vote counts and percentages for each configured provider, allowing you to analyze which server lists are performing best, identify trends across different platforms, and make data-driven decisions about which providers to focus on. The response includes both absolute vote counts and percentage breakdowns, making it easy to visualize provider performance. Use this endpoint to build provider comparison dashboards, generate reports, or analyze the effectiveness of different server list integrations. Available on Growth plan or higher.

Request

http

GET https://api.votepipe.com/v1/stats/by-provider?from=2026-01-01&to=2026-01-31
Authorization: Bearer mr_live_your_api_key_here

Query Parameters

Parameter	Type	Required	Description
from	string	No	Start date (default: 30 days ago)
to	string	No	End date (default: now)

Response (200 OK)

json

{
  "data": {
    "providers": [
      {
        "key": "hytale-servers-pro",
        "name": "Hytale-Servers.pro",
        "count": 250,
        "percentage": 73.1
      },
      {
        "key": "hytale-servers-pro",
        "name": "Hytale-Servers.pro",
        "count": 92,
        "percentage": 26.9
      }
    ],
    "total": 342
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Learn More

→ Statistics Endpoints → GET /v1/stats/dashboard