Skip to main content
GET
/
v1
/
analytics
/
global
curl https://api.bouncy.ai/v1/analytics/summary \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
curl "https://api.bouncy.ai/v1/analytics/summary?tag=summer2026" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
// Get overall summary
const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/summary',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const summary = await response.json();
console.log(`Total clicks: ${summary.totalClicks}`);
console.log(`Average per link: ${summary.averageClicksPerLink}`);
// Get analytics for a specific campaign
const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/summary?tag=summer2026&startDate=2026-06-01&endDate=2026-08-31',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const campaignAnalytics = await response.json();
console.log(`Campaign clicks: ${campaignAnalytics.totalClicks}`);
import requests

response = requests.get(
    'https://api.bouncy.ai/v1/analytics/summary',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
    params={
        'tag': 'summer2026',
        'startDate': '2026-06-01',
        'endDate': '2026-08-31'
    }
)

summary = response.json()
print(f"Total clicks: {summary['totalClicks']}")
print(f"Top link: {summary['topLinks'][0]['shortUrl']}")
{
  "totalLinks": 245,
  "totalClicks": 45678,
  "uniqueVisitors": 32456,
  "averageClicksPerLink": 186,
  "topLinks": [
    {
      "linkId": "link_abc123",
      "shortUrl": "https://bouncy.ai/summer",
      "clicks": 2345
    },
    {
      "linkId": "link_def456",
      "shortUrl": "https://bouncy.ai/promo",
      "clicks": 1987
    },
    {
      "linkId": "link_ghi789",
      "shortUrl": "https://bouncy.ai/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 }
  ]
}
{
  "totalLinks": 15,
  "totalClicks": 5678,
  "uniqueVisitors": 4123,
  "averageClicksPerLink": 378,
  "topLinks": [
    {
      "linkId": "link_summer1",
      "shortUrl": "https://bouncy.ai/summer-ig",
      "clicks": 987
    }
  ],
  "topCountries": [
    { "country": "US", "clicks": 2345 },
    { "country": "GB", "clicks": 1234 }
  ],
  "clicksOverTime": [
    { "date": "2026-06-01", "clicks": 45 },
    { "date": "2026-06-02", "clicks": 67 }
  ]
}

Request

Headers

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

Total number of links included in analytics
totalClicks
number
Aggregate click count across all links
uniqueVisitors
number
Aggregate unique visitors across all links
Average clicks per link
Top performing links
topCountries
array
Top countries by click count
clicksOverTime
array
Daily click counts
curl https://api.bouncy.ai/v1/analytics/summary \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
curl "https://api.bouncy.ai/v1/analytics/summary?tag=summer2026" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
// Get overall summary
const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/summary',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const summary = await response.json();
console.log(`Total clicks: ${summary.totalClicks}`);
console.log(`Average per link: ${summary.averageClicksPerLink}`);
// Get analytics for a specific campaign
const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/summary?tag=summer2026&startDate=2026-06-01&endDate=2026-08-31',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const campaignAnalytics = await response.json();
console.log(`Campaign clicks: ${campaignAnalytics.totalClicks}`);
import requests

response = requests.get(
    'https://api.bouncy.ai/v1/analytics/summary',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
    params={
        'tag': 'summer2026',
        'startDate': '2026-06-01',
        'endDate': '2026-08-31'
    }
)

summary = response.json()
print(f"Total clicks: {summary['totalClicks']}")
print(f"Top link: {summary['topLinks'][0]['shortUrl']}")
{
  "totalLinks": 245,
  "totalClicks": 45678,
  "uniqueVisitors": 32456,
  "averageClicksPerLink": 186,
  "topLinks": [
    {
      "linkId": "link_abc123",
      "shortUrl": "https://bouncy.ai/summer",
      "clicks": 2345
    },
    {
      "linkId": "link_def456",
      "shortUrl": "https://bouncy.ai/promo",
      "clicks": 1987
    },
    {
      "linkId": "link_ghi789",
      "shortUrl": "https://bouncy.ai/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 }
  ]
}
{
  "totalLinks": 15,
  "totalClicks": 5678,
  "uniqueVisitors": 4123,
  "averageClicksPerLink": 378,
  "topLinks": [
    {
      "linkId": "link_summer1",
      "shortUrl": "https://bouncy.ai/summer-ig",
      "clicks": 987
    }
  ],
  "topCountries": [
    { "country": "US", "clicks": 2345 },
    { "country": "GB", "clicks": 1234 }
  ],
  "clicksOverTime": [
    { "date": "2026-06-01", "clicks": 45 },
    { "date": "2026-06-02", "clicks": 67 }
  ]
}