analytics

Get project analytics

Plan: All plans

Returns analytics for a published project: the historical time series and breakdowns for a date range by default, or the real-time visitor trend with series=trend.

get/v1/projects/{project_id}/analytics

Path parameters

project_idstring required

Project ID

Project ID

Query parameters

series'historical' | 'trend'

historical returns the time series and breakdowns for the requested date range; trend returns the real-time visitor trend for the last 30 minutes.

historical returns the time series and breakdowns for the requested date range; trend returns the real-time visitor trend for the last 30 minutes.

start_datestring

Start date in RFC 3339 format (e.g. 2026-04-01T00:00:00Z). Required when series=historical.

Start date in RFC 3339 format (e.g. 2026-04-01T00:00:00Z). Required when series=historical.

end_datestring

End date in RFC 3339 format (e.g. 2026-04-08T00:00:00Z). Required when series=historical.

End date in RFC 3339 format (e.g. 2026-04-08T00:00:00Z). Required when series=historical.

startDatestring

Deprecated alias for start_date.

Deprecated alias for start_date.

endDatestring

Deprecated alias for end_date.

Deprecated alias for end_date.

granularitystring

Time bucket size for series=historical: hourly or daily (default: daily).

Time bucket size for series=historical: hourly or daily (default: daily).

Response

OK

Example response

{
  "lists": {
    "country": {
      "data": [
        {
          "label": "/pricing",
          "value": 1280
        }
      ],
      "label": "Top Pages"
    },
    "device": {
      "data": [
        {
          "label": "/pricing",
          "value": 1280
        }
      ],
      "label": "Top Pages"
    },
    "page": {
      "data": [
        {
          "label": "/pricing",
          "value": 1280
        }
      ],
      "label": "Top Pages"
    },
    "source": {
      "data": [
        {
          "label": "/pricing",
          "value": 1280
        }
      ],
      "label": "Top Pages"
    }
  },
  "timeSeries": {
    "bounceRate": {
      "data": [
        {
          "date": "2026-01-15 00:00:00",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "pageviews": {
      "data": [
        {
          "date": "2026-01-15 00:00:00",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "pageviewsPerVisit": {
      "data": [
        {
          "date": "2026-01-15 00:00:00",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "sessionDuration": {
      "data": [
        {
          "date": "2026-01-15 00:00:00",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "visitors": {
      "data": [
        {
          "date": "2026-01-15 00:00:00",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    }
  },
  "trend": {
    "currentVisitors": 12,
    "data": [
      {
        "time": "2026-01-15 09:30:00",
        "visits": 42
      }
    ]
  }
}

Changes