API REST LinkTwin

API de raccourcisseur d'URL : automatisez des liens qui s'ouvrent dans la bonne application.

Créez, gérez et suivez des liens courts depuis votre propre code. Chaque lien créé par l'API est un deep link LinkTwin : sur un téléphone, il ouvre YouTube, Amazon, Spotify et plus de 100 autres applications au lieu d'un navigateur. Connectez-la à Zapier, n8n, Make, Airtable, Google Sheets ou à tout ce qui peut envoyer une requête HTTP.

Voir la documentation

API RESTful JSON
Un seul Bearer token
Accès API avec tous les plans

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
// Créer un lien court avec l'API LinkTwin
$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 ou plus récent, avec le fetch intégré
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

200Réponse

{
  "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."
}

Compatible avec

Zapier
n8n
Make
Airtable
Google Sheets
Slack
WordPress
Shopify
Applications personnalisées

Points d'accès API populaires

Les endpoints de l'API de liens que vous utiliserez le plus.

Chaque endpoint reçoit et renvoie du JSON en HTTPS, authentifié avec votre clé API en tant que Bearer token. Choisissez-en un pour voir une vraie requête et la réponse qu'elle renvoie.

Créer un lien court ou un deep link

Envoyez l'URL longue et les options éventuelles en JSON. Seul url est obligatoire. Collez une URL YouTube, Amazon ou Spotify et le lien court ouvre cette application sur un téléphone.

url obligatoire
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"}
    ]
  }'

200Réponse

{
  "error": 0,
  "id": "1225",
  "shorturl": "https://linktw.in/desk-lamp",
  "title": "Amazon: LED desk lamp with clamp",
  "description": null
}

Les champs que vous utiliserez le plus
`url`	L'URL longue à raccourcir (requis)string
`custom`	Alias personnalisé pour l'URL courte (facultatif)string
`expiry`	Date d'expiration du lien (facultatif)datetime
`password`	Protéger le lien par mot de passe (facultatif)string
`domain`	Un domaine de marque déjà ajouté à votre comptestring
`clicklimit`	Nombre maximum de clics avant l'expiration du lieninteger
`geotarget`	Envoyez les visiteurs d'un pays, ou d'un État, vers une autre URLarray
`devicetarget`	Une URL différente pour iPhone, Android et les autres appareilsarray
`languagetarget`	Une URL différente pour chaque langue de navigateurarray
`abtesting`	Répartissez le trafic entre les variantes en pourcentagearray
`parameters`	UTM et autres paramètres ajoutés à la redirectionarray
`pixels, collections`	ID ou noms des pixels et collections à associerarray

Voir cet endpoint dans la documentation de l'API

Lister et rechercher vos liens

Parcourez vos liens page par page, triez-les par date, clics ou nom, et filtrez par texte, date ou collection.

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"

200Réponse, abrégée

{
  "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": []
      }
    ]
  }
}

Voir cet endpoint dans la documentation de l'API

Obtenir un lien

Passez l'ID du lien ou son URL courte complète. Vous obtenez les règles de ciblage, l'expiration, les collections et les pixels, ainsi que ses compteurs de clics.

:id obligatoire
timezone

GET/api/url/:id

curl "https://linktw.in/api/url/1221" \
  -H "Authorization: Bearer YOUR_API_KEY"

200Réponse, abrégée

{
  "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
  }
}

Voir cet endpoint dans la documentation de l'API

Modifier un lien

Envoyez seulement les champs que vous voulez modifier. Le lien court reste le même : chaque post et chaque QR code qui l'utilise suit la nouvelle destination.

:id obligatoire
url
et tous les champs de création

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"}'

200Réponse

{
  "error": 0,
  "id": 1221,
  "shorturl": "https://linktw.in/desk-tour",
  "title": "Unboxing my new camera",
  "description": null
}

Voir cet endpoint dans la documentation de l'API

Lire les analyses des clics

Clics, clics uniques, référent et pays principaux, un graphique quotidien et des répartitions par pays, référent, navigateur, appareil et langue pour un lien.

:id obligatoire
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"

200Réponse, abrégée

{
  "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
      }
    ]
  }
}

Le serveur MCP et la CLI lisent aussi les analyses des liens via cet endpoint.

Créer un QR code

Choisissez un type (texte, vCard, lien, e-mail, téléphone, SMS ou Wi-Fi), les données, et en option des couleurs et un logo. Les QR codes de liens comptent les scans, et vous pouvez changer leur destination plus tard.

type obligatoire
data obligatoire
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)"}'

200Réponse

{
  "error": 0,
  "id": 3,
  "link": "https://linktw.in/qr/a58f79"
}

Voir cet endpoint dans la documentation de l'API

Ajouter des liens à une collection

Ajoutez et retirez de nombreux liens en un seul appel. Le même principe permet d'associer un pixel de retargeting à de nombreux liens via /api/pixel/:id/links.

:id obligatoire
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]}'

200Réponse

{
  "error": 0,
  "collection_id": 4,
  "added": [
    1221,
    1222,
    1223
  ],
  "removed": [],
  "errors": []
}

Voir cet endpoint dans la documentation de l'API

Supprimer un lien

Supprimez un lien par son ID ou son URL courte, ou plusieurs à la fois avec POST /api/urls/delete et une liste d'ID.

:id obligatoire

DELETE/api/url/:id/delete

curl -X DELETE "https://linktw.in/api/url/1223/delete" \
  -H "Authorization: Bearer YOUR_API_KEY"

200Réponse

{
  "error": 0,
  "message": "Link has been successfully deleted."
}

Voir cet endpoint dans la documentation de l'API

Exemples de requêtes et de réponses. Les champs et formats des réponses sont réels ; les liens et les chiffres sont des données d'exemple.

Cas d'utilisation

Que pouvez-vous construire avec notre API ?

D'un Zap en une étape à une intégration complète dans votre propre produit, voici les tâches que les équipes confient à l'API LinkTwin.

Génération automatique de liens

Créez automatiquement des liens courts lorsque de nouveaux produits sont ajoutés, des articles de blog sont publiés ou du contenu est téléchargé. Parfait pour les plateformes e-commerce et de contenu.

Shopify
WordPress
WooCommerce

Gestion de liens en masse

Importez des milliers d'URLs depuis des tableurs, générez des liens courts en masse et exportez-les. Idéal pour les campagnes marketing et les programmes d'affiliation.

Google Sheets
Excel
Import CSV

URL longue	Lien court
youtube.com/watch?v=x7K2pQ9mW4s	linktw.in/desk-tour
amazon.com/dp/B0CJ4LQ7M2	linktw.in/my-keyboard
open.spotify.com/playlist/37i9dQZF1	linktw.in/focus-mix

Intégration d'analyses

Importez les clics, clics uniques, référents, pays et appareils dans vos propres tableaux de bord, outils de BI ou rapports.

Looker Studio
Tableau
Power BI

Campagnes e-mail et SMS

Générez des liens de suivi uniques pour chaque destinataire dans vos campagnes email ou SMS. Suivez l'engagement individuel et optimisez vos communications.

Mailchimp
SendGrid
Twilio

Intégration d'application mobile

Créez des deep links à la volée depuis votre application mobile. Partagez du contenu avec des liens intelligents qui s'ouvrent directement dans d'autres applications au lieu du navigateur.

iOS
Android
React Native

QR codes dynamiques

Générez des QR codes par programmation pour les supports imprimés, emballages ou tickets d'événements. Mettez à jour l'URL de destination sans réimprimer.

Systèmes d'impression
Imprimantes d'étiquettes
Systèmes de point de vente

Outils pour développeurs

Intégration Zapier

Raccourcisseur d'URL pour Zapier : créez et suivez des liens depuis n'importe quel Zap.

Utilisez LinkTwin comme raccourcisseur d'URL dans vos Zaps, et laissez LinkTwin prévenir Zapier quand quelque chose se passe. Cela fonctionne aussi dans n8n, Make et tout outil qui envoie ou reçoit des webhooks.

Créer des liens depuis un Zap

Ajoutez une action Webhooks by Zapier qui envoie une requête POST à l'API LinkTwin. L'étape suivante peut utiliser le lien court renvoyé.

DéclencheurNouvelle ligne dans Google Sheets
Colonne
URL du produit
ActionWebhooks by Zapier : POST

URL
https://linktw.in/api/url/add

Type de payload
json

Données
url = {{Product URL}}

En-têtes
Authorization: Bearer YOUR_API_KEY
ActionMettre à jour la ligne avec le lien court
Lien court
{{shorturl}}

Recevez un webhook pour chaque nouveau lien et chaque clic

Collez une URL Catch Hook de Zapier sur la page d'intégration Zapier de votre tableau de bord. LinkTwin envoie un événement JSON chaque fois que vous créez un lien court et chaque fois que quelqu'un clique dessus. Cela fonctionne avec n'importe quel système de webhooks, pas seulement Zapier.

Nouveau lien

{
  "type": "url",
  "longurl": "https://www.youtube.com/watch?v=x7K2pQ9mW4s",
  "shorturl": "https://linktw.in/desk-tour",
  "date": "04-10-2026 09:41:12"
}

Nouveau clic

{
  "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"
}

Exemples de payloads avec les vrais noms de champs.

Le même principe dans n8n et Make

Utilisez le nœud HTTP Request dans n8n ou le module HTTP dans Make. Envoyez un POST à /api/url/add avec votre clé API dans l'en-tête Authorization et l'URL dans le corps, puis reliez shorturl à l'étape suivante.

Enregistrez la clé comme identifiant d'en-tête, jamais dans l'URL.
Vérifiez le champ error de la réponse : 0 signifie que le lien a été créé.
Traitements en masse : restez sous la limite de débit et lisez les en-têtes X-RateLimit.

n8n

Nœud HTTP Request, avec un identifiant Header Auth pour Authorization.

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

Make

Module HTTP, Make a request. {{1.url}} est l'URL de l'étape précédente.

{
  "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}}\"}"
}

Pourquoi choisir notre API

Conçu par des développeurs, pour des développeurs

Une API REST simple, avec un JSON prévisible, des limites claires et une documentation pour chaque endpoint.

Authentification Sécurisée

Authentification par jeton Bearer avec la possibilité de régénérer votre clé API à tout moment. Toutes les requêtes sont chiffrées via HTTPS.

Des limites de débit claires

Chaque clé API peut effectuer 120 requêtes par minute, et chaque réponse vous indique où vous en êtes.

Conception RESTful

Points d'accès propres et intuitifs suivant les conventions REST. Réponses JSON avec des messages d'erreur détaillés et des codes de statut.

{
  "error": 1,
  "message": "A valid API key is required to use this service."
}

Deep links par défaut

Les liens créés via l'API s'ouvrent dans YouTube, Amazon, Spotify et plus de 100 autres applications, exactement comme les liens créés dans le tableau de bord.

Documentation complète

Chaque endpoint est documenté avec ses paramètres, un exemple de réponse et du code en cURL, PHP et Node.js.

Voir la documentation API complète

Support développeur

Bloqué sur quelque chose ? Écrivez-nous et nous vous aiderons à faire fonctionner votre intégration.

Contactez-nous

Questions des développeurs

Questions fréquentes sur notre API, l'authentification, les limites de débit et les intégrations. Lire la documentation complète de l'API.

Comment obtenir une clé API ?

Connectez-vous et ouvrez Paramètres dans votre tableau de bord, ou les pages Serveur MCP et Outil CLI sous Outils & Intégrations. Votre clé API s'y affiche dès que votre plan inclut l'accès API, disponible avec tous les plans. Vous pouvez la régénérer à tout moment, et l'ancienne clé cesse immédiatement de fonctionner.

Quelles sont les limites de débit ?

Chaque clé API peut effectuer 120 requêtes par minute. Chaque réponse contient les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, pour que vous puissiez espacer vos appels, et une requête au-delà de la limite reçoit l'erreur 429 avec une valeur Retry-After. La création de liens a aussi son propre quota par minute et par heure, qui dépend de votre plan, indiqué dans les en-têtes X-Create-RateLimit.

Puis-je utiliser l'API avec N8N, Zapier ou Make ?

Oui. L'API fonctionne avec toute plateforme d'automatisation capable d'envoyer des requêtes HTTP : le nœud HTTP Request dans n8n, Webhooks by Zapier ou le module HTTP dans Make. LinkTwin peut aussi appeler un webhook Zapier chaque fois que vous créez un lien ou que quelqu'un clique dessus. La documentation de l'API donne le format de requête de chaque endpoint.

Quels endpoints sont disponibles ?

Liens (créer, lister, obtenir, modifier, supprimer et supprimer en masse), QR codes, collections, domaines de marque, pixels de retargeting, canaux, statistiques de clics et paramètres de votre compte. La documentation de l'API liste les paramètres et un exemple de réponse pour chacun.

L'API est-elle incluse dans le plan gratuit ?

L'accès API est disponible avec tous les plans. Vous pouvez créer un compte gratuit pour tester d'abord les liens LinkTwin, puis passer à un plan supérieur quand vous êtes prêt à développer. Consultez les plans et tarifs.

Fournissez-vous des exemples de code et des SDK ?

Oui. La documentation présente chaque requête en cURL, PHP et Node.js, et cette page ajoute Python. Pour JavaScript et TypeScript, il existe un client officiel sur npm, @linktwin/client, qui fait aussi tourner le serveur MCP et la CLI de LinkTwin.

Les liens créés via l'API s'ouvrent-ils dans les applications ?

Oui. Un lien créé via l'API fonctionne exactement comme un lien créé dans le tableau de bord. Sur un téléphone, il ouvre la bonne application, comme YouTube, Amazon ou Spotify, et bascule vers le navigateur quand l'application n'est pas installée. Voir les applications prises en charge.

Existe-t-il une intégration Zapier ?

Oui, dans les deux sens. Un Zap peut créer des liens en appelant l'API avec Webhooks by Zapier, et LinkTwin peut envoyer un webhook Zapier chaque fois que vous créez un lien ou que quelqu'un clique dessus. Collez vos URL de webhook sur la page d'intégration Zapier de votre tableau de bord.

Une clé API, trois façons de développer

L'API REST, le serveur MCP et la CLI utilisent tous la même clé API et gèrent les mêmes liens.

Serveur MCP

Laissez votre agent IA créer les liens

Voir le serveur MCP

Ligne de commande

Raccourcissez des liens depuis votre terminal

Voir la CLI LinkTwin

Documentation API

Tous les endpoints, avec des exemples

Lisez la documentation de l'API

Commencez à Construire avec Notre API Aujourd'hui

Créez votre compte, choisissez un plan avec accès API et copiez votre clé API. Documentation complète et exemples de code inclus.

Lire la documentation ou voir les plans. L'accès API est disponible avec tous les plans.

API de raccourcisseur d'URL : automatisez des liens qui s'ouvrent dans la bonne application.

Les endpoints de l'API de liens que vous utiliserez le plus.

Créer un lien court ou un deep link

Lister et rechercher vos liens

Obtenir un lien

Modifier un lien

Lire les analyses des clics

Créer un QR code

Ajouter des liens à une collection

Supprimer un lien

Que pouvez-vous construire avec notre API ?

Génération automatique de liens

Gestion de liens en masse

Intégration d'analyses

Campagnes e-mail et SMS

Intégration d'application mobile

QR codes dynamiques

Outils pour développeurs

Raccourcisseur d'URL pour Zapier : créez et suivez des liens depuis n'importe quel Zap.

Créer des liens depuis un Zap

Recevez un webhook pour chaque nouveau lien et chaque clic

Le même principe dans n8n et Make

Conçu par des développeurs, pour des développeurs

Authentification Sécurisée

Des limites de débit claires

Conception RESTful

Deep links par défaut

Documentation complète

Support développeur

Et ce qu'ils publient sur X

Questions des développeurs

Une clé API, trois façons de développer

Laissez votre agent IA créer les liens

Raccourcissez des liens depuis votre terminal

Tous les endpoints, avec des exemples

Commencez à Construire avec Notre API Aujourd'hui