API Documentation
Build on Europe's fastest URL infrastructure. RESTful JSON API with sub-30ms redirects, zero-cookie analytics, and 100% EU data residency — enforceable by contract.
Authentication
All API requests require an API key passed via the Authorization header. Generate and revoke keys in your Dashboard under API Keys (Pro & Agency plans).
curl -X GET "https://trckl.eu/v1/links" \
-H "Authorization: Bearer trckl_live_your_api_key"
💡 All API traffic is encrypted end-to-end and processed exclusively on EU infrastructure.
Endpoints
/v1/links
Create a short link
Creates a new short link. Validates destination for safety and generates a short slug automatically unless a custom slug is provided.
Request
curl -X POST "https://trckl.eu/v1/links" \
-H "Authorization: Bearer trckl_live_..." \
-H "Content-Type: application/json" \
-d '{
"destination": "https://example.com/my-long-page",
"slug": "my-link",
"label": "campaign-q2"
}'
Response 201
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"slug": "my-link",
"destination": "https://example.com/my-long-page",
"label": "campaign-q2",
"created_at": "2026-11-16T10:30:00.000Z",
"short_url": "https://trckl.eu/my-link"
}
}
/v1/links
List all links
Returns up to 100 active short links in your workspace under data, ordered newest first.
/v1/links/{link_id}
Delete a link
Soft-deletes a short link and purges its edge redirect cache immediately (204 No Content).
/v1/links/{link_id}/analytics
Link analytics
Returns privacy-safe analytics for a link: total & unique clicks, geographic breakdown (country-level only via offline GeoLite2), device types, traffic sources / referrers, campaign tags, and daily trend. No PII or raw IPs are ever collected or returned.
Response 200
{
"data": {
"total_clicks": 1247,
"unique_clicks": 982,
"devices": { "desktop": 723, "mobile": 489, "tablet": 35 },
"countries": { "DE": 412, "FR": 298, "IT": 187, "NL": 134 },
"referrers": { "linkedin": 342, "direct": 298 },
"utm_sources": { "newsletter": 195 },
"utm_mediums": { "email": 195 },
"utm_campaigns": { "q4-launch": 195 },
"daily_trend": [{ "day": "2026-11-15", "clicks": 84 }]
}
}
Quickstart Examples
const res = await fetch('https://trckl.eu/v1/links', {
method: 'POST',
headers: {
'Authorization': 'Bearer trckl_live_...',
'Content-Type': 'application/json',
},
body: JSON.stringify({
destination: 'https://example.com',
label: 'newsletter',
}),
});
const { data } = await res.json();
console.log(data.short_url);
// → https://trckl.eu/abc123
import requests
res = requests.post(
"https://trckl.eu/v1/links",
headers={"Authorization": "Bearer trckl_live_..."},
json={
"destination": "https://example.com",
"label": "newsletter",
},
)
print(res.json()["data"]["short_url"])
# → https://trckl.eu/abc123
Rate Limits & Data Residency
Rate Limits
Pro & Agency API keys: 60 requests / minute per key
Monthly link quotas: 1,000 / mo on Pro (€12/mo), unlimited on Agency (€39/mo)
Requests exceeding the per-minute limit return HTTP 429 Too Many Requests.
Data Residency
All API traffic is handled directly by EU-only origin servers.
Zero cookies set, zero raw IP addresses persisted on disk, and self-serve Art. 28 DPA PDF in your dashboard.
Ready to build?
Create your account and upgrade to Pro (€12/mo) to generate an API key and start creating GDPR-native short links in minutes.
rocket_launch Get API Access →