curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"type": "deeplink",
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found for \"my-link\"."
}
Links
Get Link
Retrieve details for a specific short link
GET
/
v1
/
links
/
{identifier}
curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"type": "deeplink",
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found for \"my-link\"."
}
Request
Headers
Path Parameters
string
required
Any of:
- the link
idreturned by GET /v1/links (e.g.,my-linkortapmy.social__my-link) - the slug (e.g.,
my-link), matched against your own links only - the short URL, URL-encoded (e.g.,
https%3A%2F%2Ftapmy.social%2Fmy-link)
www., and with its path as sent before the lowercase path, so custom-domain links with www. or capital letters in the path resolve. Only links owned by the API key’s account are returned.Response
boolean
Whether the operation succeeded
object
The link object
Show properties
Show properties
string
Unique identifier for the link
string
The complete short URL
string
The slug portion of the short URL
string
The destination URL where the link redirects
string
Domain used for the short URL
string
Link title
string
Link description
array
Array of tags
string
Group ID if assigned
boolean
Whether the link is currently active
string
Link type (e.g.,
app for app links)string
What the item is:
deeplink, website (a link-in-bio page) or applinkstring
Timestamp of creation
string
Timestamp of last update
curl https://api.bouncy.ai/v1/links/my-link \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links/my-link',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: link } = await response.json();
console.log(link.destination);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links/my-link',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'}
)
link = response.json()['data']
print(link['destination'])
{
"success": true,
"data": {
"id": "my-link",
"url": "https://bouncy.ai/my-link",
"slug": "my-link",
"domain": "bouncy.ai",
"destination": "https://example.com/summer-sale",
"title": "Summer Sale 2026",
"description": "50% off everything",
"tags": ["marketing", "sale"],
"groupId": null,
"isActive": true,
"linkType": null,
"type": "deeplink",
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
}
}
{
"error": "Not Found",
"message": "Deeplink not found for \"my-link\"."
}