API REST di LinkTwin

API per accorciare URL: automatizza link che si aprono nell'app giusta.

Crea, gestisci e monitora link brevi dal tuo codice. Ogni link creato dall'API è un deep link LinkTwin, quindi su un telefono apre YouTube, Amazon, Spotify e oltre 100 altre app invece di un browser. Collegala a Zapier, n8n, Make, Airtable, Google Sheets o a qualsiasi strumento in grado di inviare una richiesta HTTP.

Visualizza Documentazione

API JSON RESTful
Un solo Bearer token
Accesso API con tutti i piani

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
// Crea un link breve con l'API di 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 o successivo, con fetch integrato
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

200Risposta

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

Funziona con

Zapier
n8n
Make
Airtable
Google Sheets
Slack
WordPress
Shopify
App personalizzate

Endpoint API Popolari

Gli endpoint dell'API dei link che userai di più.

Ogni endpoint accetta e restituisce JSON su HTTPS, con autenticazione tramite la tua chiave API come Bearer token. Scegline uno per vedere una richiesta reale e la risposta che restituisce.

Crea un link breve o un deep link

Invia l'URL lungo e le eventuali opzioni in JSON. Solo url è obbligatorio. Incolla un URL di YouTube, Amazon o Spotify e il link breve aprirà quell'app su un telefono.

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

200Risposta

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

I campi che userai di più
`url`	L'URL lungo da abbreviare (obbligatorio)string
`custom`	Alias personalizzato per l'URL breve (facoltativo)string
`expiry`	Data di scadenza del link (opzionale)datetime
`password`	Proteggi il link con password (facoltativo)string
`domain`	Un dominio personalizzato che hai già aggiunto al tuo accountstring
`clicklimit`	Numero massimo di clic prima che il link scadainteger
`geotarget`	Invia i visitatori di un paese, o di uno stato, a un URL diversoarray
`devicetarget`	Un URL diverso per iPhone, Android e altri dispositiviarray
`languagetarget`	Un URL diverso per ogni lingua del browserarray
`abtesting`	Dividi il traffico tra le varianti in percentualearray
`parameters`	UTM e altri parametri aggiunti al reindirizzamentoarray
`pixels, collections`	ID o nomi di pixel e collezioni da collegarearray

Vedi questo endpoint nella documentazione API

Elenca e cerca i tuoi link

Scorri i tuoi link pagina per pagina, ordinali per data, clic o nome e filtrali per testo, data o collezione.

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"

200Risposta, abbreviata

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

Vedi questo endpoint nella documentazione API

Ottieni un link

Passa l'ID del link o il suo URL breve completo. Ottieni regole di targeting, scadenza, collezioni e pixel, più il conteggio dei clic.

:id obbligatorio
timezone

GET/api/url/:id

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

200Risposta, abbreviata

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

Vedi questo endpoint nella documentazione API

Aggiorna un link

Invia solo i campi che vuoi cambiare. Il link breve resta lo stesso, quindi ogni post e codice QR che lo usa segue la nuova destinazione.

:id obbligatorio
url
e tutti i campi di creazione

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

200Risposta

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

Vedi questo endpoint nella documentazione API

Leggi le statistiche dei clic

Clic, clic unici, referrer e paese principali, un grafico giornaliero e suddivisioni per paese, referrer, browser, dispositivo e lingua per un singolo link.

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

200Risposta, abbreviata

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

Anche il server MCP e la CLI leggono le statistiche dei link tramite questo endpoint.

Crea un codice QR

Scegli un tipo (testo, vCard, link, email, telefono, SMS o Wi-Fi), i dati e, se vuoi, colori e logo. I codici QR dei link contano le scansioni e puoi cambiarne la destinazione in seguito.

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

200Risposta

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

Vedi questo endpoint nella documentazione API

Aggiungi link a una collezione

Aggiungi e rimuovi molti link in una sola chiamata. Lo stesso schema collega un pixel di retargeting a molti link su /api/pixel/:id/links.

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

200Risposta

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

Vedi questo endpoint nella documentazione API

Elimina un link

Elimina un link per ID o URL breve, oppure molti insieme con POST /api/urls/delete e un elenco di ID.

:id obbligatorio

DELETE/api/url/:id/delete

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

200Risposta

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

Vedi questo endpoint nella documentazione API

Richieste e risposte di esempio. I campi e i formati delle risposte sono quelli reali; i link e i numeri sono dati di esempio.

Casi d'Uso

Cosa Puoi Costruire con la Nostra API?

Da uno Zap di un solo step a un'integrazione completa nel tuo prodotto, ecco i compiti che i team affidano all'API di LinkTwin.

Generazione Automatica di Link

Crea automaticamente link brevi quando vengono aggiunti nuovi prodotti, pubblicati articoli o caricati contenuti. Perfetto per e-commerce e piattaforme di contenuti.

Shopify
WordPress
WooCommerce

Gestione Link in Blocco

Importa migliaia di URL da fogli di calcolo, genera short link in massa ed esportali nuovamente. Ideale per campagne di marketing e programmi di affiliazione.

Google Sheets
Excel
Importazione CSV

URL lungo	Link breve
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

Integrazione Analytics

Porta clic, clic unici, referrer, paesi e dispositivi nelle tue dashboard, negli strumenti di BI o nei report.

Looker Studio
Tableau
Power BI

Campagne email e SMS

Genera link di tracciamento unici per ogni destinatario nelle tue campagne email o SMS. Traccia il coinvolgimento individuale e ottimizza la tua comunicazione.

Mailchimp
SendGrid
Twilio

Integrazione App Mobile

Crea deep link al volo dalla tua app mobile. Condividi contenuti con link intelligenti che si aprono direttamente in altre app invece che nei browser.

iOS
Android
React Native

Codici QR dinamici

Genera codici QR in modo programmatico per materiali stampati, packaging di prodotti o biglietti per eventi. Aggiorna l'URL di destinazione in qualsiasi momento senza ristampare.

Sistemi di Stampa
Stampanti per etichette
Sistemi POS

Strumenti per sviluppatori

Integrazione Zapier

Accorciatore di URL per Zapier: crea e monitora link da qualsiasi Zap.

Usa LinkTwin come accorciatore di URL nei tuoi Zap e lascia che LinkTwin avvisi Zapier quando succede qualcosa. Lo stesso funziona in n8n, Make e in qualsiasi strumento che invia o riceve webhook.

Crea link da uno Zap

Aggiungi un'azione Webhooks by Zapier che invia una richiesta POST all'API di LinkTwin. Lo step successivo può usare il link breve restituito.

TriggerNuova riga in Google Sheets
Colonna
URL del prodotto
AzioneWebhooks by Zapier: POST

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

Tipo di payload
json

Dati
url = {{Product URL}}

Header
Authorization: Bearer YOUR_API_KEY
AzioneAggiorna la riga con il link breve
Link breve
{{shorturl}}

Ricevi un webhook per ogni nuovo link e clic

Incolla un URL Catch Hook di Zapier nella pagina dell'integrazione Zapier della tua dashboard. LinkTwin invia un evento JSON ogni volta che crei un link breve e ogni volta che qualcuno ne clicca uno. Funziona con qualsiasi sistema di webhook, non solo Zapier.

Nuovo link

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

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

Payload di esempio con i nomi reali dei campi.

La stessa idea in n8n e Make

Usa il nodo HTTP Request in n8n o il modulo HTTP in Make. Invia una POST a /api/url/add con la tua chiave API nell'header Authorization e l'URL nel body, poi mappa shorturl nello step successivo.

Salva la chiave come credenziale nell'header, mai nell'URL.
Controlla il campo error nella risposta: 0 significa che il link è stato creato.
Operazioni in blocco: resta sotto il limite di utilizzo e leggi gli header X-RateLimit.

n8n

Nodo HTTP Request, con una credenziale Header Auth per Authorization.

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

Make

Modulo HTTP, Make a request. {{1.url}} è l'URL dello step precedente.

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

Perché Scegliere la Nostra API

Costruito per Sviluppatori, da Sviluppatori

Una semplice API REST con JSON prevedibile, limiti chiari e documentazione per ogni endpoint.

Autenticazione sicura

Autenticazione con token Bearer con possibilità di rigenerare la chiave API in qualsiasi momento. Tutte le richieste sono crittografate via HTTPS.

Limiti di utilizzo chiari

Ogni chiave API può fare 120 richieste al minuto, e ogni risposta ti dice a che punto sei.

Design RESTful

Endpoint puliti e intuitivi secondo le convenzioni REST. Risposte JSON con messaggi di errore dettagliati e codici di stato.

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

Deep link di serie

I link creati tramite l'API si aprono in YouTube, Amazon, Spotify e oltre 100 altre app, esattamente come i link creati nella dashboard.

Documentazione completa

Ogni endpoint è documentato con i suoi parametri, una risposta di esempio e codice in cURL, PHP e Node.js.

Visualizza Documentazione API Completa

Supporto sviluppatori

Bloccato su qualcosa? Scrivici e ti aiuteremo a far funzionare la tua integrazione.

Contattaci

Domande degli sviluppatori

Domande frequenti sulla nostra API, autenticazione, limiti di utilizzo e integrazioni. Leggi la documentazione API completa.

Come posso ottenere una chiave API?

Accedi e apri Impostazioni nella tua dashboard, oppure le pagine Server MCP e Strumento CLI in Strumenti e integrazioni. La tua chiave API compare lì quando il tuo piano include l'accesso API, disponibile con tutti i piani. Puoi rigenerarla in qualsiasi momento, e la vecchia chiave smette subito di funzionare.

Quali sono i limiti di frequenza?

Ogni chiave API può fare 120 richieste al minuto. Ogni risposta contiene gli header X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset, così puoi regolare il ritmo delle chiamate, e una richiesta oltre il limite riceve l'errore 429 con un valore Retry-After. Anche la creazione di link ha un proprio limite al minuto e all'ora che dipende dal tuo piano, indicato negli header X-Create-RateLimit.

Posso usare l'API con N8N, Zapier o Make?

Sì. L'API funziona con qualsiasi piattaforma di automazione in grado di inviare richieste HTTP: il nodo HTTP Request in n8n, Webhooks by Zapier o il modulo HTTP in Make. LinkTwin può anche chiamare un webhook di Zapier ogni volta che crei un link o qualcuno ne clicca uno. La documentazione API riporta il formato della richiesta per ogni endpoint.

Quali endpoint sono disponibili?

Link (creazione, elenco, lettura, aggiornamento, eliminazione ed eliminazione in blocco), codici QR, collezioni, domini personalizzati, pixel di retargeting, canali, statistiche dei clic e impostazioni del tuo account. La documentazione API elenca i parametri e una risposta di esempio per ciascuno.

L'API è inclusa nel piano gratuito?

L'accesso API è disponibile con tutti i piani. Puoi creare un account gratuito per provare prima i link LinkTwin, poi passare a un piano superiore quando sei pronto a sviluppare. Vedi piani e prezzi.

Fornite esempi di codice e SDK?

Sì. La documentazione mostra ogni richiesta in cURL, PHP e Node.js, e questa pagina aggiunge Python. Per JavaScript e TypeScript c'è un client ufficiale su npm, @linktwin/client, che alimenta anche il server MCP e la CLI di LinkTwin.

I link creati tramite l'API si aprono nelle app?

Sì. Un link creato tramite l'API funziona esattamente come uno creato nella dashboard. Su un telefono apre l'app giusta, come YouTube, Amazon o Spotify, e ripiega sul browser quando l'app non è installata. Vedi le app supportate.

Esiste un'integrazione con Zapier?

Sì, in entrambe le direzioni. Uno Zap può creare link chiamando l'API con Webhooks by Zapier, e LinkTwin può inviare un webhook a Zapier ogni volta che crei un link o qualcuno ne clicca uno. Incolla gli URL dei tuoi webhook nella pagina dell'integrazione Zapier della tua dashboard.

Una chiave API, tre modi per sviluppare

L'API REST, il server MCP e la CLI usano tutti la stessa chiave API e gestiscono gli stessi link.

Server MCP

Lascia che sia il tuo agente AI a creare i link

Scopri il server MCP

Riga di comando

Abbrevia i link dal tuo terminale

Scopri la CLI di LinkTwin

Documentazione API

Ogni endpoint, con esempi

Leggi la documentazione API

Inizia a costruire con la nostra API oggi

Crea il tuo account, scegli un piano con accesso API e copia la tua chiave API. Documentazione completa ed esempi di codice inclusi.

Leggi la documentazione o vedi i piani. L'accesso API è disponibile con tutti i piani.

API per accorciare URL: automatizza link che si aprono nell'app giusta.

Gli endpoint dell'API dei link che userai di più.

Crea un link breve o un deep link

Elenca e cerca i tuoi link

Ottieni un link

Aggiorna un link

Leggi le statistiche dei clic

Crea un codice QR

Aggiungi link a una collezione

Elimina un link

Cosa Puoi Costruire con la Nostra API?

Generazione Automatica di Link

Gestione Link in Blocco

Integrazione Analytics

Campagne email e SMS

Integrazione App Mobile

Codici QR dinamici

Strumenti per sviluppatori

Accorciatore di URL per Zapier: crea e monitora link da qualsiasi Zap.

Crea link da uno Zap

Ricevi un webhook per ogni nuovo link e clic

La stessa idea in n8n e Make

Costruito per Sviluppatori, da Sviluppatori

Autenticazione sicura

Limiti di utilizzo chiari

Design RESTful

Deep link di serie

Documentazione completa

Supporto sviluppatori

E cosa pubblicano su X

Domande degli sviluppatori

Una chiave API, tre modi per sviluppare

Lascia che sia il tuo agente AI a creare i link

Abbrevia i link dal tuo terminale

Ogni endpoint, con esempi

Inizia a costruire con la nostra API oggi