API

Kurzlinks per REST-API erstellen

Erstelle und verwalte Kurzlinks programmatisch – REST, JSON, API-Keys. Verfügbar ab dem Business-Plan.

API-Key erstellen

Im Dashboard unter „API“ – der Key wird nur einmal angezeigt.

Request senden

REST + JSON, Bearer-Auth. Ein POST genügt für den ersten Kurzlink.

Klicks auswerten

Statistik pro Link abrufen – cookielos erhoben, DSGVO-konform.

Beispiel

Ein Request. Ein Kurzlink.

Derselbe Aufruf in deiner Sprache – POST /api/v1/links legt den Link an, die Antwort enthält sofort die Kurz-URL.

POST /api/v1/links

curl -X POST https://kurzuri.de/api/v1/links \
  -H "Authorization: Bearer kzr_DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetUrl": "https://example.com/sommer-kampagne",
    "slug": "sommer",
    "title": "Sommer-Kampagne"
  }'

201 Created · application/json

{
  "id": "42",
  "slug": "sommer",
  "shortUrl": "https://kurzuri.de/sommer",
  "targetUrl": "https://example.com/sommer-kampagne",
  "title": "Sommer-Kampagne",
  "domain": null,
  "active": true,
  "blocked": false,
  "hasPassword": false,
  "clicks": 0,
  "expiresAt": null,
  "createdAt": "2026-06-11T12:00:00.000Z"
}

Authentifizierung

Erstelle einen API-Key im Dashboard unter „API“ und sende ihn als Bearer-Token. Der Key wird nur einmal angezeigt und serverseitig ausschließlich als Hash gespeichert.

curl https://kurzuri.de/api/v1/me \
  -H "Authorization: Bearer kzr_DEIN_API_KEY"

Endpunkte

Basis-URL: https://kurzuri.de/api/v1

Methode	Pfad	Beschreibung
GET	/links	Links auflisten (Cursor-Pagination)
POST	/links	Link anlegen
GET	/links/{id}	Link abrufen
PATCH	/links/{id}	Link ändern (Teilupdate)
DELETE	/links/{id}	Link löschen
GET	/links/{id}/stats	Klick-Statistik
GET	/domains	Verifizierte eigene Domains
GET	/me	Konto, Plan & Verbräuche

Maschinenlesbare Spezifikation: /api/v1/openapi.json (OpenAPI 3.1)

Beispiel

Klick-Statistik abrufen

Klicks pro Tag, Länder, Geräte, Browser und Referrer – pro Link, komplett cookielos erhoben.

GET /api/v1/links/{id}/stats

curl https://kurzuri.de/api/v1/links/42/stats \
  -H "Authorization: Bearer kzr_DEIN_API_KEY"

200 OK · application/json

{
  "linkId": "42",
  "totalClicks": 1284,
  "clicksByDay": [
    { "date": "2026-06-10", "clicks": 96 },
    { "date": "2026-06-11", "clicks": 124 }
  ],
  "topCountries": [
    { "label": "DE", "clicks": 873 },
    { "label": "AT", "clicks": 244 }
  ],
  "topDevices": [
    { "label": "mobile", "clicks": 781 },
    { "label": "desktop", "clicks": 503 }
  ],
  "topBrowsers": [{ "label": "Chrome", "clicks": 590 }],
  "topReferrers": [{ "label": "Direkt / QR", "clicks": 642 }]
}

Rate-Limits

120 Anfragen pro Minute und Key. Jede Antwort enthält RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset; bei Überschreitung kommt 429 mit Retry-After.

Fehler

Fehler folgen RFC 9457 (application/problem+json):

422 Unprocessable Entity

{
  "type": "https://kurzuri.de/api-docs#fehler",
  "title": "Validierung fehlgeschlagen",
  "status": 422,
  "detail": "targetUrl ist erforderlich."
}

Bereit für deinen ersten API-Request?

API-Zugang ist ab dem Business-Plan enthalten. Key erstellen, Request senden, fertig.

API-Key erstellen Pläne ansehen