curl "https://api.bouncy.ai/v1/links?page=1&limit=25" \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links?page=1&limit=25',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: links, pagination } = await response.json();
console.log(`Page ${pagination.page} of ${pagination.totalPages} (${pagination.totalCount} total)`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
params={
'page': 1,
'limit': 25
}
)
data = response.json()
print(f"Page {data['pagination']['page']} of {data['pagination']['totalPages']}")
{
"data": [
{
"id": "summer-sale",
"url": "https://bouncy.ai/summer-sale",
"slug": "summer-sale",
"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,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
},
{
"id": "promo",
"url": "https://bouncy.ai/promo",
"slug": "promo",
"domain": "bouncy.ai",
"destination": "https://example.com/promo",
"title": "Special Promotion",
"description": null,
"tags": ["marketing"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-01-28T15:20:00Z",
"updatedAt": "2026-02-03T09:15:00Z"
}
],
"pagination": {
"page": 1,
"limit": 25,
"totalCount": 245,
"totalPages": 10,
"hasMore": true
}
}
Links
List Links
Retrieve a paginated list of your short links with optional filtering
GET
/
v1
/
links
curl "https://api.bouncy.ai/v1/links?page=1&limit=25" \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links?page=1&limit=25',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: links, pagination } = await response.json();
console.log(`Page ${pagination.page} of ${pagination.totalPages} (${pagination.totalCount} total)`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
params={
'page': 1,
'limit': 25
}
)
data = response.json()
print(f"Page {data['pagination']['page']} of {data['pagination']['totalPages']}")
{
"data": [
{
"id": "summer-sale",
"url": "https://bouncy.ai/summer-sale",
"slug": "summer-sale",
"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,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
},
{
"id": "promo",
"url": "https://bouncy.ai/promo",
"slug": "promo",
"domain": "bouncy.ai",
"destination": "https://example.com/promo",
"title": "Special Promotion",
"description": null,
"tags": ["marketing"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-01-28T15:20:00Z",
"updatedAt": "2026-02-03T09:15:00Z"
}
],
"pagination": {
"page": 1,
"limit": 25,
"totalCount": 245,
"totalPages": 10,
"hasMore": true
}
}
Request
Headers
Query Parameters
Page number for paginationExample:
1Number of links per page (max: 100)Example:
25Search across slugs, titles, and destination URLsExample:
summerFilter by tag nameExample:
marketingFilter by domainExample:
bouncy.aiFilter by group IDExample:
grp_abc123Response
Array of link objects
curl "https://api.bouncy.ai/v1/links?page=1&limit=25" \
-H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY"
const response = await fetch(
'https://api.bouncy.ai/v1/links?page=1&limit=25',
{
headers: {
'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'
}
}
);
const { data: links, pagination } = await response.json();
console.log(`Page ${pagination.page} of ${pagination.totalPages} (${pagination.totalCount} total)`);
import requests
response = requests.get(
'https://api.bouncy.ai/v1/links',
headers={'Authorization': 'Bearer bcy_live_pk_YOUR_API_KEY'},
params={
'page': 1,
'limit': 25
}
)
data = response.json()
print(f"Page {data['pagination']['page']} of {data['pagination']['totalPages']}")
{
"data": [
{
"id": "summer-sale",
"url": "https://bouncy.ai/summer-sale",
"slug": "summer-sale",
"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,
"createdAt": "2026-02-01T12:00:00Z",
"updatedAt": "2026-02-05T10:30:00Z"
},
{
"id": "promo",
"url": "https://bouncy.ai/promo",
"slug": "promo",
"domain": "bouncy.ai",
"destination": "https://example.com/promo",
"title": "Special Promotion",
"description": null,
"tags": ["marketing"],
"groupId": null,
"isActive": true,
"linkType": null,
"createdAt": "2026-01-28T15:20:00Z",
"updatedAt": "2026-02-03T09:15:00Z"
}
],
"pagination": {
"page": 1,
"limit": 25,
"totalCount": 245,
"totalPages": 10,
"hasMore": true
}
}
⌘I