Kurzlinks aus deinem Programm.

Anlegen, ändern, auswerten – per HTTP, mit einem Zugangsschlüssel. Gehört zum Pro-Tarif.

Wofür das gut ist

Immer dann, wenn Kurzlinks nicht einzeln von Hand entstehen: Das Kassensystem druckt jeden Bon mit einem eigenen Bewertungs-Code. Das Redaktionssystem legt zu jedem Artikel einen Teilen-Link an. Ein Skript erzeugt morgens die Kampagnen-Links des Tages und schreibt die Klickzahlen der Vorwoche in eine Tabelle. Wer so etwas einmal von Hand gemacht hat, weiß, warum es eine Schnittstelle gibt.

In vier Schritten

1. Schlüssel anlegen

Im Profil unter Programmierschnittstelle. Er wird einmal angezeigt und danach nirgends mehr – wir speichern nur seinen Abdruck. Geht er verloren, ziehst du ihn zurück und legst einen neuen an. Ein Schlüssel beginnt mit flk_, damit er auffällt, falls er versehentlich in einem Protokoll oder auf GitHub landet.

2. Erster Aufruf

$ curl -H "Authorization: Bearer flk_…" \ https://1337.kiwi/api/me

Antwortet mit deinem Konto, deinen Rechten und deinen Limits. Wenn das klappt, klappt der Rest auch.

3. Kurzlink anlegen

$ curl -X POST https://1337.kiwi/api/links \ -H "Authorization: Bearer flk_…" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.org/sehr/lange/adresse","title":"Speisekarte"}'

Zurück kommt der fertige Kurzlink. Optional gehen mit: code für eine Wunsch-Adresse, expires für ein Ablaufdatum (JJJJ-MM-TT), password für einen Zugriffsschutz.

4. Klickzahlen abrufen

$ curl -H "Authorization: Bearer flk_…" \ https://1337.kiwi/api/links/abc123/stats

"total": 42 "last": "2026-08-14" "days": { "2026-08-14": 7 }

Mehr gibt es nicht – und zwar nicht, weil wir es zurückhalten, sondern weil es nicht existiert. Es gibt keine Herkunft, kein Gerät, kein Land und keinen sekundengenauen Zeitpunkt, weil einzelne Aufrufe bei uns nie gespeichert werden. Wer eine API sucht, die Besucherprofile liefert, ist hier falsch; wer eine sucht, die nichts sammelt, was sie nicht braucht, ist richtig.

Was du sonst noch wissen willst

Alle Endpunkte: GET /api/me, GET und POST /api/links, dazu GET, PATCH und DELETE /api/links/{code} sowie GET /api/links/{code}/stats. PATCH ändert nur die Felder, die du mitschickst – ein Aufruf, der bloß das Ziel umbiegt, lässt den Namen in Ruhe.

Grenzen: 300 Anfragen je Stunde und Schlüssel, höchstens zehn Schlüssel pro Konto. Es gelten dieselben Tarif-Limits wie in der Oberfläche – die Schnittstelle ist ein zweiter Weg zur Anmeldung, keine zweite Erlaubnis.

Umzug von einem anderen Dienst? Dafür ist der CSV-Import im Login-Bereich der kürzere Weg: Er liest die Ausfuhren von Bitly und YOURLS unverändert und behält dabei deine bisherigen Kurzcodes.

Die vollständige Beschreibung mit allen Feldern, Fehlercodes und Beispielen steht im offenen Quelltext: API.md bei flatlink. Dort lässt sich auch nachlesen, dass die Schnittstelle wirklich nur das speichert, was hier steht – warum das offenliegt.

Noch kein Pro?

Der API-Zugriff gehört zum Pro-Tarif für 30 € im Jahr – zusammen mit Wunsch-Adressen, längerer Statistik und QR-Codes ohne Absenderzeile. Anfragen geht formlos, wir antworten persönlich.