Analytics Endpoints

Retrieve analytics data for your timers and account usage.

GET/api/v1/timers/:id/analytics

Get analytics for a specific timer.

Response

{
  "data": {
    "timerId": "abc123",
    "totalViews": 15420,
    "viewsToday": 342,
    "viewsThisWeek": 2841,
    "viewsThisMonth": 8523,
    "dailyViews": [
      { "date": "2024-12-01", "views": 521 },
      { "date": "2024-12-02", "views": 483 },
      { "date": "2024-12-03", "views": 612 }
    ]
  }
}

Query Parameters

Parameter	Type	Description
startDate	string	Start date (YYYY-MM-DD)
endDate	string	End date (YYYY-MM-DD)
granularity	string	daily, weekly, monthly

GET/api/v1/usage

Get your account usage statistics.

Response

{
  "data": {
    "plan": "pro",
    "timers": {
      "used": 12,
      "limit": 50
    },
    "views": {
      "used": 45230,
      "limit": 100000,
      "periodStart": "2024-12-01",
      "periodEnd": "2024-12-31"
    },
    "api": {
      "requestsToday": 342,
      "requestsThisMonth": 8421
    }
  }
}

Pro Features

The following analytics data is only available on Pro plans and above:

• Geographic breakdown by country
• Device type (desktop/mobile) breakdown
• Hourly view data
• Email client statistics

Timer Endpoints

Create and manage timers

Authentication

API key setup