---
title: "Get site analytics"
method: GET
path: "/sites/{id}/analytics"
tags: ["Sites"]
---

# Get site analytics

`GET /sites/{id}/analytics`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/sites/{id}/analytics`
- Auth: API key in header `Authorization`

Returns traffic analytics for a site over a date range: pageview/visitor totals, new vs. returning visitors, a default conversion funnel, a per-day time series, and top pages, referrers, and dimensional breakdowns (device, browser, OS, geography, and UTM parameters). Defaults to the last 30 days; the range cannot exceed 366 days.

## Path parameters

- `id` string, required

## Query parameters

- `start_date` string, date
- `end_date` string, date

## Response `200`

Site analytics for the requested period

- object
  - `object` 'site_analytics', required
  - `site_id` string, required: Prefix id of the site (e.g. site_abc123).
  - `period` object, required: The resolved date range the metrics cover.
    - `start_date` string, date, required
    - `end_date` string, date, required
  - `totals` object, required: Aggregate pageviews and unique visitors over the period.
    - `pageviews` integer
    - `visitors` integer
  - `new_vs_returning` object: Visitors active in the period split by whether their first-ever visit was before the period started.
    - `new_visitors` integer
    - `returning_visitors` integer
  - `funnel` object[]: Ordered conversion funnel; each stage counts visitors who reached it within 24h of the first stage.
    - `label` string
    - `visitors` integer
  - `by_day` object[]: Per-day pageviews and visitors time series.
    - `date` string, date
    - `pageviews` integer
    - `visitors` integer
  - `top_pages` object[]: Top 20 pages by pageviews.
    - `path` string
    - `pageviews` integer
    - `visitors` integer
  - `top_referrers` object[]: Top 20 referrer hosts by visitors.
    - `source` string
    - `pageviews` integer
    - `visitors` integer
  - `custom_events` object[]: Top 20 custom events by hit count, with unique visitors and any associated revenue.
    - `event_name` string
    - `hits` integer
    - `visitors` integer
    - `revenue` number
  - `by_device` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_browser` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_os` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_country` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_region` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_city` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_utm_source` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_utm_medium` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer
  - `by_utm_campaign` object[]: Top 20 values for a single analytics dimension, ranked by unique visitors.
    - `value` string
    - `pageviews` integer
    - `visitors` integer

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `404`: Resource not found
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)