Click Analytics

Click Analytics reports aggregated click counts across your links, grouped by one dimension at a time via group_by.

Grouping dimensions

group_by value Groups clicks by
link (default) Individual link
country Visitor country
city Visitor city
os Operating system
device Device type (desktop, mobile, etc.)
browser Browser
referrer Referring source

Response shape

Each row in items represents one value of the chosen dimension:

Field Description
name The dimension value (e.g. a country name, or empty string if unknown).
count Total clicks for this value.
unique_count Unique clicks for this value.
percentage This value’s share of the total selected clicks.

The response also includes total_count / total_unique_count across all rows, the period (start_date/end_date) that was queried, and pagination for the items list.

Filters

Results can be scoped with: date range (start_date, end_date), one or more link_ids, external_id, short_url, long_url (partial match), collection_id, and one or more country, city, or device values. exclude_bots (default false) removes bot traffic from the counts.

See the Clicks Analytics tag in the API Reference, and the Read click analytics guide.