Public API

Our public API allows you to programmatically shorten URLs. No API key or authentication required.

📥 POST /api/links

Send a single object or array of objects to shorten URLs.

{
  "domain": "clc.is",
  "target_url": "https://example.com",
  "slug": "custom", // optional
  "expired_url": "https://expired.example.com", // optional
  "expired_hours": 48 // optional (0 = no expiration)
}

🔁 Response:

{
  "input": { ... },
  "slug": "custom",
  "url": "https://clc.is/custom",
  "is_generated": false
}

🌐 GET /api/domains

Returns an array of available domains for shortening links.

["clc.is", "alt1.com", "alt2.com"]

⚠️ Error Handling

409 Conflict — if the slug is already taken
400 Bad Request — missing or invalid parameters

📦 Bulk Processing

For submitting up to 5000 URLs at once, use the Bulk page or send an array of entries to /api/links.