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
string
Filter analytics from this date (ISO 8601 format: YYYY-MM-DD)Example:
2026-01-01string
Filter analytics up to this date (ISO 8601 format: YYYY-MM-DD)Example:
2026-01-31string
Filter to links with this specific tagExample:
summer2026string
Filter to links in this groupExample:
grp_abc123Response
number
Total number of links included in analytics
number
Aggregate click count across all links
number
Aggregate unique visitors across all links
number
Average clicks per link
array
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