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

{
  "id": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "slug": "summer",
  "destination": "https://example.com/summer-sale",
  "title": "Summer Sale 2026",
  "description": "50% off everything",
  "tags": ["marketing", "sale"],
  "domain": "bouncy.link",
  "createdAt": "2026-02-01T12:00:00Z",
  "updatedAt": "2026-02-05T10:30:00Z",
  "enabled": true,
  "clicks": 1234,
  "uniqueVisitors": 892,
  "lastClickAt": "2026-02-06T11:45:00Z"
}

​
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

​
Response

​
id
string
Unique identifier for the link
​
shortUrl
string
The complete short URL
​
slug
string
The slug portion of the short URL
​
destination
string
The destination URL where the link redirects
​
title
string
Link title for SEO and social sharing
​
description
string
Link description for SEO and social cards
​
tags
array
Array of tags associated with this link
​
domain
string
Domain used for the short URL
​
createdAt
string
ISO 8601 timestamp of creation
​
updatedAt
string
ISO 8601 timestamp of last update
​
enabled
boolean
Whether the link is currently active
​
clicks
number
Total click count
​
uniqueVisitors
number
Number of unique visitors
​
lastClickAt
string
ISO 8601 timestamp of last click (null if never clicked)
curl https://api.bouncy.ai/v1/links/link_abc123xyz \
  -H "X-Api-Key: bcy_live_pk_YOUR_API_KEY"

{
  "id": "link_abc123xyz",
  "shortUrl": "https://bouncy.link/summer",
  "slug": "summer",
  "destination": "https://example.com/summer-sale",
  "title": "Summer Sale 2026",
  "description": "50% off everything",
  "tags": ["marketing", "sale"],
  "domain": "bouncy.link",
  "createdAt": "2026-02-01T12:00:00Z",
  "updatedAt": "2026-02-05T10:30:00Z",
  "enabled": true,
  "clicks": 1234,
  "uniqueVisitors": 892,
  "lastClickAt": "2026-02-06T11:45:00Z"
}