FattyURL API
Create links, read analytics, import in bulk. JSON in, JSON out, Bearer token auth. Every account gets a free tier; paid plans raise the rate.
Authentication
Send your key as a Bearer token on every request.
Authorization: Bearer fatty_your_key_here
Create a short link
curl -X POST https://fattyurl.com/api/v1/shorten \
-H "Authorization: Bearer $FATTYURL_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/a-long-link", "custom_slug": "launch-2026"}'
Endpoints
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/shorten | Create one link |
| GET | /api/v1/links | List your links |
| GET | /api/v1/links/{id} | One link |
| PATCH | /api/v1/links/{id} | Change the destination or title |
| GET | /api/v1/links/{id}/clicks | Click log, paginated |
| POST | /api/v1/bulk | Create many at once |
| GET | /api/v1/export | All your links as CSV |
Rate limits
| Plan | Requests/hour | Bulk per call |
|---|---|---|
| Free | 0 | — |
| Pro | 1000 | 100 |
| Pro | 1000 | 100 |
| Business | 10000 | 500 |
| Business | 10000 | 500 |
| Enterprise | 100000 | 1000 |
Over the limit returns 429 with a
Retry-After header. Beyond your bulk ceiling returns
402.
Links made through the API are still permanent
The rate limit is on creating links, not on keeping them. If you stop paying, or never pay at all, every link you already made keeps working. That is the promise, and it applies to the API exactly as it applies to the website.