PWpwapps
Events (Clicks)

Get Event Time Series for Charts 📈

Changed on

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

Request

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.

interval'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'

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

  • e8c43917ce17Revision changes
    • breaking

      for the query request parameter endDate, default value was changed from 2026-10-15T08:08:32.847887 to 2026-10-17T11:43:47.260048

    • breaking

      for the query request parameter startDate, default value was changed from 2026-10-08T08:08:32.847875 to 2026-10-10T11:43:47.260037

  • 8192c8eaff3bRevision changes
    • breaking

      for the query request parameter endDate, default value was changed from 2026-10-14T15:18:42.197372 to 2026-10-15T08:08:32.847887

    • breaking

      for the query request parameter startDate, default value was changed from 2026-10-07T15:18:42.197360 to 2026-10-08T08:08:32.847875