urlshortner.com
DEVELOPER PLATFORM

REST API Reference

Build automated link shortening, programmatic UTM tracking, and analytics pipelines into your applications with sub-20ms edge latency.

BASE ENDPOINT
https://urlshortner.com/api/v1
RATE LIMIT
1,000 req/min (Free)
RESPONSE FORMAT
JSON (application/json)
POST/api/v1/shorten

Create a new shortened link with optional custom slug, UTM tags, and password protection.

// Example cURL Request
curl -X POST https://urlshortner.com/api/v1/shorten \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://github.com/my-awesome-project",
    "custom_slug": "my-project",
    "utm_source": "twitter"
  }'
// 200 OK JSON Response
{
  "status": "success",
  "data": {
    "short_url": "https://urlshortner.com/my-project",
    "slug": "my-project",
    "original_url": "https://github.com/my-awesome-project?utm_source=twitter",
    "qr_code_svg": "https://urlshortner.com/api/v1/qr/my-project.svg",
    "created_at": "2026-09-04T12:00:00Z"
  }
}
GET/api/v1/stats/:slug

Retrieve real-time click counts, referral breakdown, and device telemetry for a specific short link.

// Example cURL Request
curl https://urlshortner.com/api/v1/stats/my-project
// 200 OK JSON Response
{
  "slug": "my-project",
  "total_clicks": 1429,
  "unique_visitors": 1180,
  "top_referrers": {
    "twitter": 772,
    "direct": 314,
    "linkedin": 200
  },
  "platforms": {
    "mobile": 971,
    "desktop": 400,
    "tablet": 58
  }
}
START IN SECONDS

Ready to simplify your links?

No account creation, no credit cards, and zero ads. Just clean, high-performance URLs.

Shorten a Link NowCheck Click Statistics