Get Event Time Series for Charts 📈

Get time-series data for app events aggregated by interval (hour/day/week/month). Perfect for creating trading-chart-like visualizations with scrolling and zoom. Filters events by specified tracker(s).

get/api/v1/events/graph

Query parameters

trackerstring[] nullable

startDatestring date-time

Start date for the time series (ISO 8601 format). Required.

endDatestring date-time

End date for the time series (ISO 8601 format). Required.

Time interval for data aggregation. Choose based on your date range:

hour: For ranges < 7 days (detailed view)
day: For ranges < 3 months (default)
week: For ranges < 1 year
month: For ranges > 1 year (overview)

Response

Successful Response

intervalstring required

Time interval used for aggregation

startDatestring date-time required

endDatestring date-time required

totalDataPointsinteger required

summaryobject required

Example response

{
  "dataPoints": [
    {
      "clicks": 150,
      "firstSales": 25,
      "installs": 100,
      "leads": 50,
      "repeatedSales": 10,
      "timestamp": "2024-01-01T00:00:00Z"
    }
  ],
  "endDate": "2024-01-31T23:59:59Z",
  "interval": "day",
  "startDate": "2024-01-01T00:00:00Z",
  "summary": {
    "totalClicks": 4650,
    "totalEvents": 10385,
    "totalFirstSales": 775,
    "totalInstalls": 3100,
    "totalLeads": 1550,
    "totalRepeatedSales": 310,
    "uniqueClicks": 3720
  },
  "totalDataPoints": 31
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.