FattyURL API
Create links from your own code. Included in Pro and Business: 2,000 or 10,000 bulk links a month, by API or CSV import.
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 |
| GET | /api/v1/export | All your links as CSV |
Rate limits
| Plan | Bulk links a month | Requests a minute |
|---|---|---|
| Free | 0 | 0 |
| Pro | 2,000 | 60 |
| Business | 10,000 | 120 |
| Enterprise | 100,000 | 300 |
Bulk links a month counts new links made by API or CSV import together, from the 1st
of each month (UTC). Links made on the website don't count. Every
POST /api/v1/shorten answer carries
X-Monthly-Limit and
X-Monthly-Remaining.
Over either limit returns 429 with a
Retry-After header. Over the monthly limit, the answer
also has "code": "monthly_limit" and an
upgrade_url.
Links made through the API are still permanent
The rate limit is on creating links, not on keeping them. If you stop paying, every link keeps working at fattyurl.com. Links on your own domain stop 7 days after your plan ends. That is the promise, and it applies to the API exactly as it applies to the website.