GET /v1/stats/trend

Growth+

Retrieve vote trend data with customizable date ranges and granularity options. This endpoint returns time-series data showing vote counts over time, allowing you to visualize voting patterns, identify trends, and analyze growth. You can specify the date range, choose between daily, weekly, or monthly granularity, and optionally filter by provider. Use this endpoint to build trend charts, analyze seasonal patterns, track growth over time, or identify anomalies in voting activity. The flexible granularity options make it suitable for both short-term daily tracking and long-term monthly analysis. Available on Growth plan or higher.

Request

http

GET https://api.votepipe.com/v1/stats/trend?from=2026-01-01&to=2026-01-31&granularity=day
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)
granularity	string	No	day, week, or month (default: day)
provider	string	No	Filter by provider key

Response (200 OK)

json

{
  "data": {
    "trend": [
      { "date": "2026-01-01", "count": 45 },
      { "date": "2026-01-02", "count": 52 },
      { "date": "2026-01-03", "count": 48 }
    ],
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-31T23:59:59Z",
    "granularity": "day"
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Learn More

→ Statistics Endpoints → GET /v1/stats/dashboard