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
LinkTwin REST-API
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.
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
// 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 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
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
// 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
{
"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."
}
Beliebte API-Endpunkte
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.
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.
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"}
]
}'
{
"error": 0,
"id": "1225",
"shorturl": "https://linktw.in/desk-lamp",
"title": "Amazon: LED desk lamp with clamp",
"description": null
}
url | Die lange URL zum Kürzen (erforderlich)string |
|---|---|
custom | Benutzerdefinierter Alias für die Kurz-URL (optional)string |
expiry | Ablaufdatum für den Link (optional)datetime |
password | Link mit Passwort schützen (optional)string |
domain | Eine Marken-Domain, die Sie bereits zu Ihrem Konto hinzugefügt habenstring |
clicklimit | Maximale Anzahl an Klicks, bevor der Link abläuftinteger |
geotarget | Besucher aus einem Land oder Bundesland zu einer anderen URL schickenarray |
devicetarget | Eine andere URL für iPhone, Android und andere Gerätearray |
languagetarget | Eine andere URL für jede Browsersprachearray |
abtesting | Traffic prozentual auf Varianten aufteilenarray |
parameters | UTM- und andere Parameter, die bei der Weiterleitung angehängt werdenarray |
pixels, collections | IDs oder Namen von Pixeln und Sammlungen, die angehängt werdenarray |
Blättern Sie durch Ihre Links, sortieren Sie sie nach Datum, Klicks oder Name und filtern Sie nach Text, Datum oder Sammlung.
curl "https://linktw.in/api/urls?limit=2&page=1&order=clicks_desc" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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": []
}
]
}
}
Übergeben Sie die Link-ID oder die vollständige Kurz-URL. Sie erhalten die Targeting-Regeln, das Ablaufdatum, Sammlungen und Pixel sowie die Klickzahlen.
curl "https://linktw.in/api/url/1221" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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
}
}
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.
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"}'
{
"error": 0,
"id": 1221,
"shorturl": "https://linktw.in/desk-tour",
"title": "Unboxing my new camera",
"description": null
}
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.
curl "https://linktw.in/api/statistics/link/1221?date_range=30d" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"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.
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.
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)"}'
{
"error": 0,
"id": 3,
"link": "https://linktw.in/qr/a58f79"
}
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.
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]}'
{
"error": 0,
"collection_id": 4,
"added": [
1221,
1222,
1223
],
"removed": [],
"errors": []
}
Löschen Sie einen Link per ID oder Kurz-URL oder viele auf einmal mit POST /api/urls/delete und einer Liste von IDs.
curl -X DELETE "https://linktw.in/api/url/1223/delete" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"error": 0,
"message": "Link has been successfully deleted."
}
Beispielanfragen und -antworten. Felder und Formate der Antworten sind echt, die Links und Zahlen sind Beispieldaten.
Anwendungsfälle
Vom einstufigen Zap bis zur kompletten Integration in Ihr eigenes Produkt: Diese Aufgaben übergeben Teams an die LinkTwin-API.
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.
Importieren Sie Tausende URLs aus Tabellenkalkulationen, generieren Sie Kurzlinks in Masse und exportieren Sie sie zurück. Ideal für Marketingkampagnen und Affiliate-Programme.
Holen Sie Klicks, einzigartige Klicks, Referrer, Länder und Geräte in Ihre eigenen Dashboards, BI-Tools oder Berichte.
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.
Erstellen Sie Deep Links spontan von Ihrer mobilen App. Teilen Sie Inhalte mit smarten Links, die direkt in anderen Apps statt in Browsern öffnen.
QR-Codes programmatisch generieren für Druckmaterialien, Produktverpackungen oder Veranstaltungstickets. Ziel-URL jederzeit ohne Neudruck aktualisieren.
Zapier-Integration
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.
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.
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.
{
"type": "url",
"longurl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
"shorturl": "https://linktw.in/desk-tour",
"date": "04-10-2026 09:41:12"
}
{
"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.
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.
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 }}" }
]
}
}
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
Eine schlichte REST-API mit vorhersehbarem JSON, klaren Limits und Dokumentation für jeden Endpunkt.
Bearer-Token-Authentifizierung mit der Möglichkeit, Ihren API-Schlüssel jederzeit neu zu generieren. Alle Anfragen werden über HTTPS verschlüsselt.
Jeder API-Schlüssel kann 120 Anfragen pro Minute stellen, und jede Antwort zeigt Ihnen Ihren aktuellen Stand.
Saubere, intuitive Endpunkte nach REST-Konventionen. JSON-Antworten mit detaillierten Fehlermeldungen und Statuscodes.
Über die API erstellte Links öffnen sich in YouTube, Amazon, Spotify und über 100 weiteren Apps, genau wie im Dashboard erstellte Links.
Jeder Endpunkt ist mit seinen Parametern, einer Beispielantwort und Code in cURL, PHP und Node.js dokumentiert.
Vollständige API-Dokumentation anzeigenKommen Sie nicht weiter? Schreiben Sie uns, und wir helfen Ihnen, Ihre Integration zum Laufen zu bringen.
Kontaktieren Sie unsHäufige Fragen zu unserer API, Authentifizierung, Rate Limits und Integrationen. Vollständige API-Dokumentation lesen.
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.
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.
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.
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.
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.
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.
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.
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.
Die REST-API, der MCP-Server und die CLI nutzen alle denselben API-Schlüssel und verwalten dieselben Links.
MCP-Server
Befehlszeile
API-Dokumentation
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.