LinkTwin REST-API

URL-Shortener-API: Automatisieren Sie Links, die in der richtigen App öffnen.

Erstellen, verwalten und tracken Sie Kurzlinks aus Ihrem eigenen Code. Jeder Link, den die API erstellt, ist ein LinkTwin-Deep-Link und öffnet sich auf dem Handy in YouTube, Amazon, Spotify und über 100 weiteren Apps statt in einem Browser. Verbinden Sie die API mit Zapier, n8n, Make, Airtable, Google Sheets oder allem, was eine HTTP-Anfrage senden kann.

Dokumentation anzeigen
cURL
curl -X POST "https://linktw.in/api/url/add" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=x7K2pQ9mW4s", "custom": "desk-tour"}'
PHP
<?php
// Einen Kurzlink mit der LinkTwin-API erstellen
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://linktw.in/api/url/add",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "url" => "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
        "custom" => "desk-tour",
    ]),
]);
$response = json_decode(curl_exec($curl));
echo $response->shorturl; // https://linktw.in/desk-tour
Node.js
// Node.js 18 oder neuer, mit dem integrierten fetch
const res = await fetch("https://linktw.in/api/url/add", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LINKTWIN_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://www.youtube.com/watch?v=x7K2pQ9mW4s", custom: "desk-tour" }),
});
const data = await res.json();
console.log(data.shorturl); // https://linktw.in/desk-tour
Python
import requests

response = requests.post(
    "https://linktw.in/api/url/add",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"url": "https://www.youtube.com/watch?v=x7K2pQ9mW4s", "custom": "desk-tour"},
)
print(response.json()["shorturl"])  # https://linktw.in/desk-tour
TypeScript
// npm install @linktwin/client
import { LinkTwinClient } from "@linktwin/client";

const client = new LinkTwinClient({ apiKey: process.env.LINKTWIN_API_KEY });
const link = await client.links.create({
  url: "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  custom: "desk-tour",
});
console.log(link.shorturl); // https://linktw.in/desk-tour
200Antwort
{
  "error": 0,
  "id": "1221",
  "shorturl": "https://linktw.in/desk-tour",
  "title": "My $200 desk setup (full tour)",
  "description": "A full tour of my $200 desk setup."
}
Funktioniert mit
  • Zapier
  • n8n
  • Make
  • Airtable
  • Google Sheets
  • Slack
  • WordPress
  • Shopify
  • Benutzerdefinierte Apps

Beliebte API-Endpunkte

Die Link-API-Endpunkte, die Sie am häufigsten nutzen.

Jeder Endpunkt nimmt JSON über HTTPS entgegen und gibt JSON zurück, authentifiziert mit Ihrem API-Schlüssel als Bearer-Token. Wählen Sie einen aus, um eine echte Anfrage und die zugehörige Antwort zu sehen.

Kurzlink oder Deep Link erstellen

Senden Sie die lange URL und beliebige Optionen als JSON. Nur url ist erforderlich. Fügen Sie eine YouTube-, Amazon- oder Spotify-URL ein, und der Kurzlink öffnet auf dem Handy diese App.

  • url erforderlich
  • custom
  • password
  • domain
  • expiry
  • clicklimit
  • expirationredirect
  • note
  • display_title
  • metatitle
  • metadescription
  • metaimage
  • pixels
  • collections
  • geotarget
  • devicetarget
  • languagetarget
  • abtesting
  • parameters
  • escape_inapp_browser
POST/api/url/add
curl -X POST "https://linktw.in/api/url/add" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.amazon.com/dp/B09T3KX8QV?tag=mayamakes-20",
    "custom": "desk-lamp",
    "collections": ["Amazon picks"],
    "geotarget": [
      {"location": "United Kingdom", "link": "https://www.amazon.co.uk/dp/B09T3KX8QV?tag=mayamakes-21"}
    ]
  }'
200Antwort
{
  "error": 0,
  "id": "1225",
  "shorturl": "https://linktw.in/desk-lamp",
  "title": "Amazon: LED desk lamp with clamp",
  "description": null
}
Die Felder, die Sie am häufigsten nutzen
urlDie lange URL zum Kürzen (erforderlich)string
customBenutzerdefinierter Alias für die Kurz-URL (optional)string
expiryAblaufdatum für den Link (optional)datetime
passwordLink mit Passwort schützen (optional)string
domainEine Marken-Domain, die Sie bereits zu Ihrem Konto hinzugefügt habenstring
clicklimitMaximale Anzahl an Klicks, bevor der Link abläuftinteger
geotargetBesucher aus einem Land oder Bundesland zu einer anderen URL schickenarray
devicetargetEine andere URL für iPhone, Android und andere Gerätearray
languagetargetEine andere URL für jede Browsersprachearray
abtestingTraffic prozentual auf Varianten aufteilenarray
parametersUTM- und andere Parameter, die bei der Weiterleitung angehängt werdenarray
pixels, collectionsIDs oder Namen von Pixeln und Sammlungen, die angehängt werdenarray

Diesen Endpunkt in der API-Dokumentation ansehen

Ihre Links auflisten und durchsuchen

Blättern Sie durch Ihre Links, sortieren Sie sie nach Datum, Klicks oder Name und filtern Sie nach Text, Datum oder Sammlung.

  • limit
  • page
  • order
  • search
  • date_from
  • date_to
  • collections
  • timezone
GET/api/urls
curl "https://linktw.in/api/urls?limit=2&page=1&order=clicks_desc" \
  -H "Authorization: Bearer YOUR_API_KEY"
200Antwort, gekürzt
{
  "error": 0,
  "data": {
    "result": 9,
    "perpage": 2,
    "currentpage": 1,
    "nextpage": 2,
    "maxpage": 5,
    "urls": [
      {
        "id": 1221,
        "alias": "desk-tour",
        "shorturl": "https://linktw.in/desk-tour",
        "longurl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
        "title": "My $200 desk setup (full tour)",
        "clicks": 1764,
        "uniqueclicks": 1418,
        "date": "2026-08-06 21:41:00",
        "collections": [],
        "pixels": []
      },
      {
        "id": 1222,
        "alias": "new-camera",
        "shorturl": "https://linktw.in/new-camera",
        "longurl": "https://www.youtube.com/watch?v=Rt5pL0aZc1Q",
        "title": "Unboxing my new camera",
        "clicks": 1098,
        "uniqueclicks": 1045,
        "date": "2026-09-21 18:52:00",
        "collections": [],
        "pixels": []
      }
    ]
  }
}

Diesen Endpunkt in der API-Dokumentation ansehen

Einen Link abrufen

Übergeben Sie die Link-ID oder die vollständige Kurz-URL. Sie erhalten die Targeting-Regeln, das Ablaufdatum, Sammlungen und Pixel sowie die Klickzahlen.

  • :id erforderlich
  • timezone
GET/api/url/:id
curl "https://linktw.in/api/url/1221" \
  -H "Authorization: Bearer YOUR_API_KEY"
200Antwort, gekürzt
{
  "error": 0,
  "id": 1221,
  "details": {
    "id": 1221,
    "alias": "desk-tour",
    "shorturl": "https://linktw.in/desk-tour",
    "longurl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
    "domain": "https://linktw.in",
    "title": "My $200 desk setup (full tour)",
    "pass": false,
    "expiry": null,
    "clicklimit": null,
    "date": "2026-08-06 21:41:00",
    "collections": [
      {
        "id": 4,
        "name": "YouTube",
        "description": null,
        "color": "#ff0033"
      }
    ],
    "pixels": []
  },
  "data": {
    "clicks": 1764,
    "uniqueClicks": 1418
  }
}

Diesen Endpunkt in der API-Dokumentation ansehen

Einen Link aktualisieren

Senden Sie nur die Felder, die Sie ändern möchten. Der Kurzlink bleibt gleich, daher folgt jeder Post und jeder QR-Code, der ihn nutzt, dem neuen Ziel.

  • :id erforderlich
  • url
  • und alle Felder zum Erstellen
PUT/api/url/:id/update
curl -X PUT "https://linktw.in/api/url/1221/update" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=Rt5pL0aZc1Q", "expiry": "2026-12-31 23:59:59"}'
200Antwort
{
  "error": 0,
  "id": 1221,
  "shorturl": "https://linktw.in/desk-tour",
  "title": "Unboxing my new camera",
  "description": null
}

Diesen Endpunkt in der API-Dokumentation ansehen

Klick-Analysen abrufen

Klicks, einzigartige Klicks, Top-Referrer und Top-Land, ein Tagesdiagramm sowie Aufschlüsselungen nach Land, Referrer, Browser, Gerät und Sprache für einen Link.

  • :id erforderlich
  • date_range
  • start_date
  • end_date
  • timezone
GET/api/statistics/link/:id
curl "https://linktw.in/api/statistics/link/1221?date_range=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
200Antwort, gekürzt
{
  "error": 0,
  "data": {
    "link": {
      "id": 1221,
      "shortUrl": "https://linktw.in/desk-tour",
      "longUrl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
      "title": "My $200 desk setup (full tour)",
      "absoluteClicks": 1764,
      "createdAt": "2026-08-06 21:41:00"
    },
    "totalClicks": 504,
    "totalUniqueClicks": 483,
    "topReferrer": "https://l.instagram.com",
    "topCountry": "United States",
    "topCountryCode": "US",
    "chartData": [
      {
        "date": "2026-09-03",
        "clicks": 19
      },
      {
        "date": "2026-09-04",
        "clicks": 20
      }
    ]
  }
}

Auch der MCP-Server und die CLI lesen Link-Analysen über diesen Endpunkt.

QR-Code erstellen

Wählen Sie einen Typ (Text, vCard, Link, E-Mail, Telefon, SMS oder WLAN), die Daten und optional Farben und Logo. Link-QR-Codes zählen Scans, und Sie können ihr Ziel später ändern.

  • type erforderlich
  • data erforderlich
  • background
  • foreground
  • logo
POST/api/qr/add
curl -X POST "https://linktw.in/api/qr/add" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "link", "data": "https://linktw.in/desk-tour", "foreground": "rgb(13,27,46)"}'
200Antwort
{
  "error": 0,
  "id": 3,
  "link": "https://linktw.in/qr/a58f79"
}

Diesen Endpunkt in der API-Dokumentation ansehen

Links zu einer Sammlung hinzufügen

Fügen Sie mit einem Aufruf viele Links hinzu oder entfernen Sie sie. Nach demselben Muster hängen Sie unter /api/pixel/:id/links ein Retargeting-Pixel an viele Links.

  • :id erforderlich
  • add
  • remove
POST/api/collection/:id/links
curl -X POST "https://linktw.in/api/collection/4/links" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"add": [1221, 1222, 1223]}'
200Antwort
{
  "error": 0,
  "collection_id": 4,
  "added": [
    1221,
    1222,
    1223
  ],
  "removed": [],
  "errors": []
}

Diesen Endpunkt in der API-Dokumentation ansehen

Einen Link löschen

Löschen Sie einen Link per ID oder Kurz-URL oder viele auf einmal mit POST /api/urls/delete und einer Liste von IDs.

  • :id erforderlich
DELETE/api/url/:id/delete
curl -X DELETE "https://linktw.in/api/url/1223/delete" \
  -H "Authorization: Bearer YOUR_API_KEY"
200Antwort
{
  "error": 0,
  "message": "Link has been successfully deleted."
}

Diesen Endpunkt in der API-Dokumentation ansehen

Beispielanfragen und -antworten. Felder und Formate der Antworten sind echt, die Links und Zahlen sind Beispieldaten.

Anwendungsfälle

Was können Sie mit unserer API erstellen?

Vom einstufigen Zap bis zur kompletten Integration in Ihr eigenes Produkt: Diese Aufgaben übergeben Teams an die LinkTwin-API.

Automatische Link-Generierung

Erstellen Sie automatisch Kurzlinks, wenn neue Produkte hinzugefügt, Blogbeiträge veröffentlicht oder Inhalte hochgeladen werden. Perfekt für E-Commerce- und Content-Plattformen.

  • Shopify
  • WordPress
  • WooCommerce

Massen-Link-Verwaltung

Importieren Sie Tausende URLs aus Tabellenkalkulationen, generieren Sie Kurzlinks in Masse und exportieren Sie sie zurück. Ideal für Marketingkampagnen und Affiliate-Programme.

  • Google Sheets
  • Excel
  • CSV-Import

Analyse-Integration

Holen Sie Klicks, einzigartige Klicks, Referrer, Länder und Geräte in Ihre eigenen Dashboards, BI-Tools oder Berichte.

  • Looker Studio
  • Tableau
  • Power BI

E-Mail- & SMS-Kampagnen

Generieren Sie einzigartige Tracking-Links für jeden Empfänger in Ihren E-Mail- oder SMS-Kampagnen. Verfolgen Sie individuelle Interaktion und optimieren Sie Ihre Ansprache.

  • Mailchimp
  • SendGrid
  • Twilio

Mobile-App-Integration

Erstellen Sie Deep Links spontan von Ihrer mobilen App. Teilen Sie Inhalte mit smarten Links, die direkt in anderen Apps statt in Browsern öffnen.

  • iOS
  • Android
  • React Native

Dynamische QR-Codes

QR-Codes programmatisch generieren für Druckmaterialien, Produktverpackungen oder Veranstaltungstickets. Ziel-URL jederzeit ohne Neudruck aktualisieren.

  • Drucksysteme
  • Etikettendrucker
  • Kassensysteme

Zapier-Integration

Zapier-URL-Shortener: Links aus jedem Zap erstellen und tracken.

Nutzen Sie LinkTwin als URL-Shortener in Ihren Zaps und lassen Sie LinkTwin Zapier benachrichtigen, wenn etwas passiert. Das funktioniert genauso in n8n, Make und jedem Tool, das Webhooks sendet oder empfängt.

Links aus einem Zap erstellen

Fügen Sie eine Webhooks-by-Zapier-Aktion hinzu, die eine POST-Anfrage an die LinkTwin-API sendet. Der nächste Schritt kann den zurückgegebenen Kurzlink verwenden.

  1. TriggerNeue Zeile in Google Sheets
    Spalte
    Produkt-URL
  2. AktionWebhooks by Zapier: POST
    URL
    https://linktw.in/api/url/add
    Payload-Typ
    json
    Daten
    url = {{Product URL}}
    Header
    Authorization: Bearer YOUR_API_KEY
  3. AktionZeile mit dem Kurzlink aktualisieren
    Kurzlink
    {{shorturl}}

Einen Webhook für jeden neuen Link und Klick erhalten

Fügen Sie eine Zapier-Catch-Hook-URL auf der Zapier-Integrationsseite in Ihrem Dashboard ein. LinkTwin sendet jedes Mal ein JSON-Event, wenn Sie einen Kurzlink erstellen und wenn jemand einen anklickt. Das funktioniert mit jedem Webhook-System, nicht nur mit Zapier.

Neuer Link
{
  "type": "url",
  "longurl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  "shorturl": "https://linktw.in/desk-tour",
  "date": "04-10-2026 09:41:12"
}
Neuer Klick
{
  "type": "view",
  "shorturl": "https://linktw.in/desk-tour",
  "country": "United States",
  "city": "Austin",
  "referer": "https://l.instagram.com",
  "os": "iOS",
  "browser": "Safari",
  "date": "2026-10-04 09:41:12"
}

Beispiel-Payloads mit den echten Feldnamen.

Dasselbe Prinzip in n8n und Make

Nutzen Sie den HTTP-Request-Node in n8n oder das HTTP-Modul in Make. Senden Sie einen POST an /api/url/add mit Ihrem API-Schlüssel im Authorization-Header und der URL im Body, und übernehmen Sie dann shorturl in den nächsten Schritt.

  • Speichern Sie den Schlüssel als Header-Zugangsdaten, nie in der URL.
  • Prüfen Sie das Feld error in der Antwort: 0 bedeutet, dass der Link erstellt wurde.
  • Massenaufträge: Bleiben Sie unter dem Rate Limit und lesen Sie die X-RateLimit-Header.
n8n

HTTP-Request-Node mit Header-Auth-Zugangsdaten für Authorization.

{
  "method": "POST",
  "url": "https://linktw.in/api/url/add",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "sendBody": true,
  "bodyParameters": {
    "parameters": [
      { "name": "url", "value": "={{ $json.url }}" }
    ]
  }
}
Make

HTTP-Modul, Make a request. {{1.url}} ist die URL aus dem vorherigen Schritt.

{
  "url": "https://linktw.in/api/url/add",
  "method": "POST",
  "headers": [
    { "name": "Authorization", "value": "Bearer YOUR_API_KEY" }
  ],
  "bodyType": "raw",
  "contentType": "application/json",
  "data": "{\"url\": \"{{1.url}}\"}"
}

Warum unsere API wählen

Von Entwicklern für Entwickler

Eine schlichte REST-API mit vorhersehbarem JSON, klaren Limits und Dokumentation für jeden Endpunkt.

Sichere Authentifizierung

Bearer-Token-Authentifizierung mit der Möglichkeit, Ihren API-Schlüssel jederzeit neu zu generieren. Alle Anfragen werden über HTTPS verschlüsselt.

Klare Rate Limits

Jeder API-Schlüssel kann 120 Anfragen pro Minute stellen, und jede Antwort zeigt Ihnen Ihren aktuellen Stand.

RESTful-Design

Saubere, intuitive Endpunkte nach REST-Konventionen. JSON-Antworten mit detaillierten Fehlermeldungen und Statuscodes.

Standardmäßig Deep Links

Über die API erstellte Links öffnen sich in YouTube, Amazon, Spotify und über 100 weiteren Apps, genau wie im Dashboard erstellte Links.

Entwickler-Support

Kommen Sie nicht weiter? Schreiben Sie uns, und wir helfen Ihnen, Ihre Integration zum Laufen zu bringen.

Kontaktieren Sie uns
Echte Posts, echte Menschen

Und was sie auf X posten

Jeder Post verlinkt auf seine Originalquelle, sodass Sie jede Empfehlung im Kontext lesen können.

Fragen von Entwicklern

Häufige Fragen zu unserer API, Authentifizierung, Rate Limits und Integrationen. Vollständige API-Dokumentation lesen.

Wie erhalte ich einen API-Schlüssel?

Melden Sie sich an und öffnen Sie Einstellungen in Ihrem Dashboard oder die Seiten MCP-Server und CLI-Tool unter Tools & Integrationen. Dort wird Ihr API-Schlüssel angezeigt, sobald Ihr Tarif API-Zugang enthält, den es in jedem Tarif gibt. Sie können ihn jederzeit neu generieren, und der alte Schlüssel funktioniert dann sofort nicht mehr.

Was sind die Ratenbegrenzungen?

Jeder API-Schlüssel kann 120 Anfragen pro Minute stellen. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, damit Sie Ihre Aufrufe takten können, und eine Anfrage über dem Limit erhält den Fehler 429 mit einem Retry-After-Wert. Für das Erstellen von Links gilt zusätzlich ein eigenes Kontingent pro Minute und pro Stunde, das von Ihrem Tarif abhängt und in X-Create-RateLimit-Headern gemeldet wird.

Kann ich die API mit N8N, Zapier oder Make verwenden?

Ja. Die API funktioniert mit jeder Automatisierungsplattform, die HTTP-Anfragen senden kann: dem HTTP-Request-Node in n8n, Webhooks by Zapier oder dem HTTP-Modul in Make. LinkTwin kann außerdem jedes Mal einen Zapier-Webhook aufrufen, wenn Sie einen Link erstellen oder jemand einen anklickt. Die API-Dokumentation enthält das Anfrageformat für jeden Endpunkt.

Welche Endpunkte sind verfügbar?

Links (erstellen, auflisten, abrufen, aktualisieren, löschen und gesammelt löschen), QR-Codes, Sammlungen, Marken-Domains, Retargeting-Pixel, Kanäle, Klickstatistiken und Ihre Kontoeinstellungen. Die API-Dokumentation listet für jeden Endpunkt die Parameter und eine Beispielantwort auf.

Ist die API im kostenlosen Tarif enthalten?

API-Zugang gibt es in jedem Tarif. Sie können ein kostenloses Konto erstellen, um LinkTwin-Links zuerst auszuprobieren, und upgraden, sobald Sie loslegen wollen. Siehe Tarife und Preise.

Bieten Sie Code-Beispiele und SDKs an?

Ja. Die Dokumentation zeigt jede Anfrage in cURL, PHP und Node.js, und diese Seite ergänzt Python. Für JavaScript und TypeScript gibt es einen offiziellen Client auf npm, @linktwin/client, der auch den LinkTwin MCP-Server und die CLI antreibt.

Öffnen sich über die API erstellte Links in Apps?

Ja. Ein über die API erstellter Link funktioniert genau wie einer aus dem Dashboard. Auf dem Handy öffnet er die richtige App, etwa YouTube, Amazon oder Spotify, und weicht auf den Browser aus, wenn die App nicht installiert ist. Siehe die unterstützten Apps.

Gibt es eine Zapier-Integration?

Ja, in beide Richtungen. Ein Zap kann Links erstellen, indem er die API mit Webhooks by Zapier aufruft, und LinkTwin kann jedes Mal einen Zapier-Webhook senden, wenn Sie einen Link erstellen oder jemand einen anklickt. Fügen Sie Ihre Webhook-URLs auf der Zapier-Integrationsseite in Ihrem Dashboard ein.

Ein API-Schlüssel, drei Wege zum Entwickeln

Die REST-API, der MCP-Server und die CLI nutzen alle denselben API-Schlüssel und verwalten dieselben Links.

MCP-Server

Lassen Sie Ihren KI-Agenten die Links erstellen

Zum MCP-Server

Noch heute mit unserer API starten

Erstellen Sie Ihr Konto, wählen Sie einen Tarif mit API-Zugang und kopieren Sie Ihren API-Schlüssel. Vollständige Dokumentation und Codebeispiele inklusive.

Dokumentation lesen oder Tarife ansehen. API-Zugang gibt es in jedem Tarif.