Integrate URL shortening and QR code generation into third-party sites and services.
Endpoint
POST
/api/v1/shorten
Headers & Auth
Content-Type: application/json
Authorization: Bearer <YOUR_ADMIN_SECRET> (or X-API-Key header / secret query param)
Request Body (JSON)
{
"url": "https://example.com/long-page-path",
"customSlug": "my-custom-alias", // optional
"isPrivate": false // optional
}
Response Example
{
"success": true,
"shortUrl": "https://kld.limo/my-custom-alias",
"url": "https://kld.limo/my-custom-alias",
"slug": "my-custom-alias",
"qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...", // Base64 PNG data URL
"qrCodeDataUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
"qrCodeUrl": "https://kld.limo/api/qr/my-custom-alias",
"qrCodeSvgUrl": "https://kld.limo/api/qr/my-custom-alias?format=svg"
}
cURL Example
curl -X POST https://kld.limo/api/v1/shorten \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_ADMIN_SECRET" \
-d '{"url": "https://example.com/long-link", "customSlug": "custom-link"}'
kld.limo