Skip to main content

​
Get Your API Key

1

Sign up for a Growth plan or higher

API access requires a Growth plan or higher ($35/month).If you’re already on a Growth, Scaling, or Dominance plan, you’re ready to go!
2

Navigate to the API Dashboard

Go to bouncy.ai/api/dashboard and log in to your account.
3

Create an API Key

Click “Create New Key”, give it a name (e.g., “Production API Key”), and click Create.
Save your API key securely! You’ll only see the full key once. Store it in a password manager or environment variable.
Your API key will look like this:
bcy_live_pk_1234567890abcdefghijklmnopqrstuvwxyz

​
Make Your First API Call

Let’s create your first short link using the API. 
curl -X POST https://api.bouncy.ai/v1/links \
  -H "Authorization: Bearer bcy_live_pk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/welcome",
    "slug": "welcome",
    "title": "Welcome Page",
    "tags": ["onboarding", "test"]
  }'

​
Expected Response

{
  "id": "link_abc123xyz",
  "shortUrl": "https://bouncy.ai/welcome",
  "slug": "welcome",
  "destination": "https://example.com/welcome",
  "title": "Welcome Page",
  "tags": ["onboarding", "test"],
  "domain": "bouncy.ai",
  "createdAt": "2026-02-06T12:00:00Z",
  "enabled": true,
  "clicks": 0
}
🎉 Congratulations! You’ve created your first short link via the API.

​
Next Steps

List Your Links

Retrieve all your links with pagination and filtering

Get Analytics

Track clicks, geography, and device information

Bulk Create Links

Create hundreds of links at once for campaigns

Error Handling

Learn how to handle API errors gracefully

​
Rate Limits

Your rate limits depend on your plan:
PlanRequests/HourRequests/Day
Growth1,00010,000
Scaling5,00050,000
Dominance10,000100,000
Rate limit information is included in every API response: 
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1738886400

​
Need Help?