Get Link or Website Analytics

curl https://api.bouncy.ai/v1/analytics/links/link_abc123xyz \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const analytics = await response.json();
console.log(`Total views: ${analytics.totalViews}`);
console.log(`Total clicks: ${analytics.totalClicks}`);
console.log(analytics.clicksByLink.map(button => ({
  id: button.id,
  title: button.title,
  totalClicks: button.totalClicks,
  dailyClicks: button.dailyClicks
})));

import requests

response = requests.get(
    'https://api.bouncy.ai/v1/analytics/links/link_abc123xyz',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
    params={
        'from': '2026-01-01',
        'to': '2026-01-31'
    }
)

analytics = response.json()
print(f"Total views: {analytics['totalViews']}")
print(f"Adult confirmations: {(analytics.get('adultConfirmation') or {}).get('clicks', 0)}")

{
  "id": "my-bio-page",
  "identifier": "my-bio-page",
  "type": "Website",
  "resolvedBy": "customSlug",
  "totalViews": 190,
  "dailyViews": [
    {
      "date": "2026-01-15",
      "views": 74,
      "clicks": 78,
      "adultClicks": 46,
      "countries": {
        "us": 41,
        "gb": 18
      },
      "devices": {
        "mobile": 69,
        "desktop": 5
      },
      "platforms": {
        "ios": 43,
        "android": 26,
        "windows": 5
      },
      "referrers": {
        "instagram.com": 38,
        "direct": 22
      }
    }
  ],
  "deviceStats": {
    "mobile": 176,
    "desktop": 14
  },
  "countryStats": [
    { "name": "United States", "views": 112 },
    { "name": "United Kingdom", "views": 49 }
  ],
  "topCountry": "United States",
  "topCountryViews": 112,
  "lastViewed": "2026-01-31T19:22:10.000Z",
  "platformStats": {
    "ios": 104,
    "android": 72,
    "windows": 14
  },
  "referrerStats": [
    { "domain": "instagram.com", "views": 89 },
    { "domain": "direct", "views": 54 }
  ],
  "totalClicks": 211,
  "clicksByLink": [
    {
      "id": "shop_0_lx8abc",
      "count": 88,
      "totalClicks": 88,
      "title": "Shop Now",
      "url": "https://example.com/shop",
      "type": "standard",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 32 },
        { "date": "2026-01-16", "clicks": 56 }
      ]
    },
    {
      "id": "adult-18plus-btn",
      "count": 123,
      "totalClicks": 123,
      "title": "Yes, I'm 18+",
      "url": "https://example.com/adult-destination",
      "type": "adult-confirmation",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 46 },
        { "date": "2026-01-16", "clicks": 77 }
      ]
    }
  ],
  "adultConfirmation": {
    "clicks": 123,
    "rate": 64.74
  }
}

{
  "error": "Link or website not found"
}

GET

analytics

links

{identifier}

curl https://api.bouncy.ai/v1/analytics/links/link_abc123xyz \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const analytics = await response.json();
console.log(`Total views: ${analytics.totalViews}`);
console.log(`Total clicks: ${analytics.totalClicks}`);
console.log(analytics.clicksByLink.map(button => ({
  id: button.id,
  title: button.title,
  totalClicks: button.totalClicks,
  dailyClicks: button.dailyClicks
})));

import requests

response = requests.get(
    'https://api.bouncy.ai/v1/analytics/links/link_abc123xyz',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
    params={
        'from': '2026-01-01',
        'to': '2026-01-31'
    }
)

analytics = response.json()
print(f"Total views: {analytics['totalViews']}")
print(f"Adult confirmations: {(analytics.get('adultConfirmation') or {}).get('clicks', 0)}")

{
  "id": "my-bio-page",
  "identifier": "my-bio-page",
  "type": "Website",
  "resolvedBy": "customSlug",
  "totalViews": 190,
  "dailyViews": [
    {
      "date": "2026-01-15",
      "views": 74,
      "clicks": 78,
      "adultClicks": 46,
      "countries": {
        "us": 41,
        "gb": 18
      },
      "devices": {
        "mobile": 69,
        "desktop": 5
      },
      "platforms": {
        "ios": 43,
        "android": 26,
        "windows": 5
      },
      "referrers": {
        "instagram.com": 38,
        "direct": 22
      }
    }
  ],
  "deviceStats": {
    "mobile": 176,
    "desktop": 14
  },
  "countryStats": [
    { "name": "United States", "views": 112 },
    { "name": "United Kingdom", "views": 49 }
  ],
  "topCountry": "United States",
  "topCountryViews": 112,
  "lastViewed": "2026-01-31T19:22:10.000Z",
  "platformStats": {
    "ios": 104,
    "android": 72,
    "windows": 14
  },
  "referrerStats": [
    { "domain": "instagram.com", "views": 89 },
    { "domain": "direct", "views": 54 }
  ],
  "totalClicks": 211,
  "clicksByLink": [
    {
      "id": "shop_0_lx8abc",
      "count": 88,
      "totalClicks": 88,
      "title": "Shop Now",
      "url": "https://example.com/shop",
      "type": "standard",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 32 },
        { "date": "2026-01-16", "clicks": 56 }
      ]
    },
    {
      "id": "adult-18plus-btn",
      "count": 123,
      "totalClicks": 123,
      "title": "Yes, I'm 18+",
      "url": "https://example.com/adult-destination",
      "type": "adult-confirmation",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 46 },
        { "date": "2026-01-16", "clicks": 77 }
      ]
    }
  ],
  "adultConfirmation": {
    "clicks": 123,
    "rate": 64.74
  }
}

{
  "error": "Link or website not found"
}

Request

Headers

Path Parameters

string

required

The link or website identifier. For websites, you can use the document ID, custom slug, or custom domain.Examples: link_abc123xyz, my-bio-page, example.com

Query Parameters

string

Preset date range. Supported values are last_7_days, last_30_days, last_90_days, this_month, last_month, and all_time.Example: last_30_days

string

Custom range start date in YYYY-MM-DD format. Must be used with to.Example: 2026-01-01

string

Custom range end date in YYYY-MM-DD format. Must be used with from.Example: 2026-01-31

Bio website button clicks are returned in clicksByLink. Each tracked button includes the link ID, title, URL, total clicks, and daily clicks for the selected range.

Response

string

Resolved Firestore document ID used for analytics lookup.

string

Identifier from the request path.

string

Resource type, such as Website or Deeplink.

string

How the identifier was matched, such as documentId, customSlug, or customDomain.

number

Total views in the selected range.

array

Time-series analytics for the selected range. For short ranges this is hourly; for longer ranges this is daily or monthly.

Show properties

string

Time bucket identifier.

number

Views in this time bucket.

number

Clicks in this time bucket.

number

Adult confirmation clicks in this time bucket.

object

View breakdown by device type.

array

Countries by view count.

Show properties

string

Country name.

number

Views from this country.

string

Highest-view country in the selected range, excluding unknown values.

number

View count for topCountry.

string | null

Timestamp of the latest view, or null when no view has been recorded.

object

View breakdown by platform or operating system.

array

Referrer domains by view count.

Show properties

string

Referrer domain.

number

Views from this referrer.

number

Total tracked clicks in the selected range. For bio websites, this is the total clicks across tracked buttons.

array

Click breakdown by tracked link or button.

Show properties

string

Tracked link/button ID. Adult confirmation clicks use adult-18plus-btn.

number

Number of clicks for this link/button. This is kept for backwards compatibility.

number

Total clicks for this link/button in the selected range.

string

Tracked link/button title.

string

Tracked destination URL.

string

Tracked link/button type. Adult confirmation clicks use adult-confirmation.

array

Daily click counts for this link/button in the selected range.

Show properties

string

Date in YYYY-MM-DD format.

number

Click count for this link/button on that date.

object | null

Adult confirmation metric for adult-gated links. Returns null when no adult confirmation clicks were tracked in the selected range.

Show properties

number

Number of users who clicked the adult confirmation button.

number

Confirmation rate as a percentage of views in the selected range.

curl https://api.bouncy.ai/v1/analytics/links/link_abc123xyz \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/link_abc123xyz?from=2026-01-01&to=2026-01-31" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

curl "https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days" \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"

const response = await fetch(
  'https://api.bouncy.ai/v1/analytics/links/my-bio-page?timeframe=last_30_days',
  {
    headers: {
      'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
    }
  }
);

const analytics = await response.json();
console.log(`Total views: ${analytics.totalViews}`);
console.log(`Total clicks: ${analytics.totalClicks}`);
console.log(analytics.clicksByLink.map(button => ({
  id: button.id,
  title: button.title,
  totalClicks: button.totalClicks,
  dailyClicks: button.dailyClicks
})));

import requests

response = requests.get(
    'https://api.bouncy.ai/v1/analytics/links/link_abc123xyz',
    headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
    params={
        'from': '2026-01-01',
        'to': '2026-01-31'
    }
)

analytics = response.json()
print(f"Total views: {analytics['totalViews']}")
print(f"Adult confirmations: {(analytics.get('adultConfirmation') or {}).get('clicks', 0)}")

{
  "id": "my-bio-page",
  "identifier": "my-bio-page",
  "type": "Website",
  "resolvedBy": "customSlug",
  "totalViews": 190,
  "dailyViews": [
    {
      "date": "2026-01-15",
      "views": 74,
      "clicks": 78,
      "adultClicks": 46,
      "countries": {
        "us": 41,
        "gb": 18
      },
      "devices": {
        "mobile": 69,
        "desktop": 5
      },
      "platforms": {
        "ios": 43,
        "android": 26,
        "windows": 5
      },
      "referrers": {
        "instagram.com": 38,
        "direct": 22
      }
    }
  ],
  "deviceStats": {
    "mobile": 176,
    "desktop": 14
  },
  "countryStats": [
    { "name": "United States", "views": 112 },
    { "name": "United Kingdom", "views": 49 }
  ],
  "topCountry": "United States",
  "topCountryViews": 112,
  "lastViewed": "2026-01-31T19:22:10.000Z",
  "platformStats": {
    "ios": 104,
    "android": 72,
    "windows": 14
  },
  "referrerStats": [
    { "domain": "instagram.com", "views": 89 },
    { "domain": "direct", "views": 54 }
  ],
  "totalClicks": 211,
  "clicksByLink": [
    {
      "id": "shop_0_lx8abc",
      "count": 88,
      "totalClicks": 88,
      "title": "Shop Now",
      "url": "https://example.com/shop",
      "type": "standard",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 32 },
        { "date": "2026-01-16", "clicks": 56 }
      ]
    },
    {
      "id": "adult-18plus-btn",
      "count": 123,
      "totalClicks": 123,
      "title": "Yes, I'm 18+",
      "url": "https://example.com/adult-destination",
      "type": "adult-confirmation",
      "dailyClicks": [
        { "date": "2026-01-15", "clicks": 46 },
        { "date": "2026-01-16", "clicks": 77 }
      ]
    }
  ],
  "adultConfirmation": {
    "clicks": 123,
    "rate": 64.74
  }
}

{
  "error": "Link or website not found"
}

Links

Geo Presets

Analytics

Groups

Domains

Websites

Account

Get Link or Website Analytics

Request

Headers

Path Parameters

Query Parameters

Response

​Request

​Headers

​Path Parameters

​Query Parameters

​Response

Request

Headers

Path Parameters

Query Parameters

Response