Integrate Koly into your applications with our RESTful API. Create, manage, and track short links programmatically.
Base URL: https://koly.com.tr/api/v1
Authentication: Bearer token using your API key
Required Plan: Pro or Team
All API requests require authentication using an API key. You can generate API keys from your account settings.
Include your API key in the Authorization header:
Authorization: Bearer koly_your_api_key_hereCreate a new short link.
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | The destination URL to shorten |
| slug | string | No | Custom slug (auto-generated if not provided) |
| title | string | No | A title for the link |
curl -X POST https://koly.com.tr/api/v1/links \
-H "Authorization: Bearer koly_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/very-long-url",
"slug": "my-link",
"title": "My Example Link"
}'{
"data": {
"id": "clx1234567890",
"url": "https://example.com/very-long-url",
"slug": "my-link",
"shortUrl": "https://koly.com.tr/s/my-link",
"title": "My Example Link",
"createdAt": "2026-02-10T12:00:00.000Z"
}
}Retrieve a paginated list of your short links.
| Parameter | Type | Default | Description |
|---|---|---|---|
| page | integer | 1 | Page number |
| limit | integer | 20 | Items per page (max 100) |
curl https://koly.com.tr/api/v1/links?page=1&limit=10 \
-H "Authorization: Bearer koly_your_api_key"{
"data": [
{
"id": "clx1234567890",
"url": "https://example.com",
"slug": "my-link",
"shortUrl": "https://koly.com.tr/s/my-link",
"title": "My Example Link",
"clicks": 142,
"createdAt": "2026-02-10T12:00:00.000Z"
}
],
"pagination": {
"page": 1,
"limit": 10,
"total": 1,
"totalPages": 1
}
}Retrieve details for a specific link.
curl https://koly.com.tr/api/v1/links/clx1234567890 \
-H "Authorization: Bearer koly_your_api_key"Delete a short link permanently.
curl -X DELETE https://koly.com.tr/api/v1/links/clx1234567890 \
-H "Authorization: Bearer koly_your_api_key"{
"data": {
"deleted": true
}
}| Status Code | Description |
|---|---|
| 200 | Success |
| 201 | Created successfully |
| 400 | Bad request - missing required fields |
| 401 | Unauthorized - invalid or missing API key |
| 403 | Forbidden - plan does not support this feature |
| 404 | Not found |
| 409 | Conflict - slug already taken |
| 500 | Internal server error |
| Plan | Rate Limit |
|---|---|
| Pro | 100 requests/minute |
| Team | 500 requests/minute |