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 }
]
}
Analytics
Get Summary Analytics
Get aggregated analytics across all your links or filter by tag
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
Filter analytics from this date (ISO 8601 format: YYYY-MM-DD)Example:
2026-01-01Filter analytics up to this date (ISO 8601 format: YYYY-MM-DD)Example:
2026-01-31Filter to links with this specific tagExample:
summer2026Filter to links in this groupExample:
grp_abc123Response
Total number of links included in analytics
Aggregate click count across all links
Aggregate unique visitors across all links
Average clicks per link
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 }
]
}
⌘I