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/shortenCreate one link
GET/api/v1/linksList your links
GET/api/v1/links/{id}One link
PATCH/api/v1/links/{id}Change the destination or title
GET/api/v1/links/{id}/clicksClick log, paginated
GET/api/v1/exportAll 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.