Skip to main content
GET
https://api.bouncy.ai
/
v1
/
analytics
/
summary
curl https://api.bouncy.ai/v1/analytics/summary \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"

{
  "totalLinks": 245,
  "totalClicks": 45678,
  "uniqueVisitors": 32456,
  "averageClicksPerLink": 186,
  "topLinks": [
    {
      "linkId": "link_abc123",
      "shortUrl": "https://bouncy.link/summer",
      "clicks": 2345
    },
    {
      "linkId": "link_def456",
      "shortUrl": "https://bouncy.link/promo",
      "clicks": 1987
    },
    {
      "linkId": "link_ghi789",
      "shortUrl": "https://bouncy.link/sale",
      "clicks": 1654
    }
  ],
  "topCountries": [
    { "country": "US", "clicks": 15678 },
    { "country": "GB", "clicks": 8765 },
    { "country": "CA", "clicks": 5432 }
  ],
  "clicksOverTime": [
    { "date": "2026-02-01", "clicks": 234 },
    { "date": "2026-02-02", "clicks": 345 },
    { "date": "2026-02-03", "clicks": 456 },
    { "date": "2026-02-04", "clicks": 389 },
    { "date": "2026-02-05", "clicks": 412 },
    { "date": "2026-02-06", "clicks": 298 }
  ]
}

​
Request

​
Headers

​
X-Api-Key
string
required
Your API key (e.g., bcy_live_pk_YOUR_API_KEY)

​
Query Parameters

​
startDate
string
Filter analytics from this date (ISO 8601 format: YYYY-MM-DD)Example: 2026-01-01
​
endDate
string
Filter analytics up to this date (ISO 8601 format: YYYY-MM-DD)Example: 2026-01-31
​
tag
string
Filter to links with this specific tagExample: summer2026
​
groupId
string
Filter to links in this groupExample: grp_abc123

​
Response

​
totalLinks
number
Total number of links included in analytics
​
totalClicks
number
Aggregate click count across all links
​
uniqueVisitors
number
Aggregate unique visitors across all links
​
averageClicksPerLink
number
Average clicks per link
​
topLinks
array
Top performing links
​
topCountries
array
Top countries by click count
​
clicksOverTime
array
Daily click counts
curl https://api.bouncy.ai/v1/analytics/summary \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"

{
  "totalLinks": 245,
  "totalClicks": 45678,
  "uniqueVisitors": 32456,
  "averageClicksPerLink": 186,
  "topLinks": [
    {
      "linkId": "link_abc123",
      "shortUrl": "https://bouncy.link/summer",
      "clicks": 2345
    },
    {
      "linkId": "link_def456",
      "shortUrl": "https://bouncy.link/promo",
      "clicks": 1987
    },
    {
      "linkId": "link_ghi789",
      "shortUrl": "https://bouncy.link/sale",
      "clicks": 1654
    }
  ],
  "topCountries": [
    { "country": "US", "clicks": 15678 },
    { "country": "GB", "clicks": 8765 },
    { "country": "CA", "clicks": 5432 }
  ],
  "clicksOverTime": [
    { "date": "2026-02-01", "clicks": 234 },
    { "date": "2026-02-02", "clicks": 345 },
    { "date": "2026-02-03", "clicks": 456 },
    { "date": "2026-02-04", "clicks": 389 },
    { "date": "2026-02-05", "clicks": 412 },
    { "date": "2026-02-06", "clicks": 298 }
  ]
}