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

{
  "linkId": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "totalClicks": 1234,
  "uniqueVisitors": 892,
  "lastClickAt": "2026-02-06T11:30:00Z",
  "topCountries": [
    { "country": "US", "clicks": 456 },
    { "country": "GB", "clicks": 234 },
    { "country": "CA", "clicks": 123 }
  ],
  "topCities": [
    { "city": "London", "country": "GB", "clicks": 89 },
    { "city": "New York", "country": "US", "clicks": 67 },
    { "city": "Toronto", "country": "CA", "clicks": 45 }
  ],
  "topReferrers": [
    { "referrer": "twitter.com", "clicks": 345 },
    { "referrer": "facebook.com", "clicks": 234 },
    { "referrer": "direct", "clicks": 189 }
  ],
  "devices": {
    "mobile": 678,
    "desktop": 456,
    "tablet": 100
  },
  "browsers": {
    "Chrome": 567,
    "Safari": 345,
    "Firefox": 234,
    "Edge": 88
  },
  "operatingSystems": {
    "iOS": 456,
    "Android": 345,
    "Windows": 234,
    "macOS": 199
  }
}

​
Request

​
Headers

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

​
Path Parameters

​
identifier
string
required
The link IDExample: link_abc123xyz

​
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

​
Response

​
linkId
string
Link ID
​
shortUrl
string
The short URL
​
totalClicks
number
Total number of clicks
​
uniqueVisitors
number
Number of unique visitors
​
lastClickAt
string
ISO 8601 timestamp of last click
​
topCountries
array
Top countries by click count
​
topCities
array
Top cities by click count
​
topReferrers
array
Top referrer sources
​
devices
object
Breakdown by device type
​
browsers
object
Breakdown by browser (Chrome, Safari, Firefox, Edge, etc.)
​
operatingSystems
object
Breakdown by OS (iOS, Android, Windows, macOS, etc.)
curl https://api.bouncy.ai/v1/analytics/links/link_abc123xyz \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"

{
  "linkId": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "totalClicks": 1234,
  "uniqueVisitors": 892,
  "lastClickAt": "2026-02-06T11:30:00Z",
  "topCountries": [
    { "country": "US", "clicks": 456 },
    { "country": "GB", "clicks": 234 },
    { "country": "CA", "clicks": 123 }
  ],
  "topCities": [
    { "city": "London", "country": "GB", "clicks": 89 },
    { "city": "New York", "country": "US", "clicks": 67 },
    { "city": "Toronto", "country": "CA", "clicks": 45 }
  ],
  "topReferrers": [
    { "referrer": "twitter.com", "clicks": 345 },
    { "referrer": "facebook.com", "clicks": 234 },
    { "referrer": "direct", "clicks": 189 }
  ],
  "devices": {
    "mobile": 678,
    "desktop": 456,
    "tablet": 100
  },
  "browsers": {
    "Chrome": 567,
    "Safari": 345,
    "Firefox": 234,
    "Edge": 88
  },
  "operatingSystems": {
    "iOS": 456,
    "Android": 345,
    "Windows": 234,
    "macOS": 199
  }
}