Create short links using API key authentication
The /api/v1/links/create endpoint allows users to create short links programmatically using API key authentication.
You can try the API endpoints in the Short Link API Playground.
Use your API key in one of two ways:
Authorization Header (Recommended):
LikeDo DocsAuthorization: Bearer YOUR_API_KEYQuery Parameter:
?key=YOUR_API_KEYRate limits are automatically configured based on your subscription tier:
POST /api/v1/links/create{
"slug": "my-link",
"targetUrl": "https://example.com",
"domain": "ig.do",
"visible": false,
"active": true,
"expiration": "-1",
"password": "123456",
"description": "My short link",
"tag"
| Parameter | Type | Required | Description |
|---|---|---|---|
slug | string | Yes | URL slug (3-100 characters, alphanumeric, hyphens, underscores) |
targetUrl | string | Yes | Destination URL (must be valid URL) |
domain | string | Yes | Domain to use for short link |
visible | boolean | No | Whether link is visible in public listings (default: false) |
active | boolean | No | Whether link is active (default: true) |
expiration | string | No | Expiration setting (default: "-1" for never) |
password | string | No | 6-character password for link protection |
description | string | No | Link description (max 500 characters) |
tag | string | No | Tag for categorization (max 50 characters) |
Access to domains is based on your subscription tier:
ig.do): Available to all userskfc.sh, uv.do): Requires Pro subscription or Lifetime planIf you attempt to use a Pro domain without proper subscription, you'll receive a 403 error.
{
"success": true,
"data": {
"id": "abc123xyz",
"slug": "my-link",
"targetUrl": "https://example.com",
"domain": "ig.do",
"shortUrl": "https://ig.do/my-link",
"visible": false,
"active":
{
"success": false,
"error": "Missing API key. Provide it via Authorization header (Bearer token) or ?key= query parameter"
}{
"success": false,
"error": "Invalid or expired API key: [error details]"
}{
"success": false,
"error": "Invalid request data",
"details": [
{
"path": ["slug"],
"message": "Slug must be at least 3 characters"
}
]
}{
"success": false,
"error": "You don't have permission to use the domain \"kfc.sh\". Premium domains require an active Pro subscription or Lifetime plan."
}{
"success": false,
"error": "A link with this slug already exists"
}curl -X POST https://your-domain.com/api/v1/links/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"slug": "example",
"targetUrl": "https://example.com",
"domain": "ig.do"
}'const response = await fetch('https://your-domain.com/api/v1/links/create', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
slug:
import requests
url = 'https://your-domain.com/api/v1/links/create'
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
}
data =
.env files or secure vaultschannel: "api" for tracking purposesapi, admin, dashboard) cannot be used as slugs