trckl.eu
Get Started
API Reference — v1 Live

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.

languageBase URL: trckl.eu/v1 codeJSON responses keyAPI Key auth

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

POST /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"
  }
}
GET /v1/links List all links

Returns up to 100 active short links in your workspace under data, ordered newest first.

DELETE /v1/links/{link_id} Delete a link

Soft-deletes a short link and purges its edge redirect cache immediately (204 No Content).

GET /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

JS
Node.js (fetch)
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
PY
Python (requests)
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

speed

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.

public

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 →

API Questions

Is there a GDPR-compliant URL shortener API? expand_more
Yes. trckl.eu provides a fully GDPR-compliant REST API for URL shortening. All data is processed and stored exclusively in the EU. The API uses zero cookies, collects no PII in analytics, and offers contractual data residency guarantees. Unlike Bitly, TinyURL, or other US-based shorteners, trckl.eu's infrastructure never touches servers outside the European Union.
What programming languages are supported? expand_more
trckl.eu provides official SDKs for Node.js, Python, and Go. The REST API can be used from any language that supports HTTP requests. All SDKs handle authentication, rate limiting, and error handling automatically.
How does trckl.eu compare to Bitly for GDPR compliance? expand_more
Bitly is a US-based service subject to the US CLOUD Act, which means user data can be accessed by US authorities regardless of where the data is stored. Bitly uses cookies and collects PII for analytics. trckl.eu is built entirely on EU infrastructure, uses zero cookies, collects no PII, and offers contractual guarantees that data never leaves the EU. For organizations that need true GDPR compliance — not just a checkbox — trckl.eu is the purpose-built alternative.