Enlaces cortos

Todas las rutas de los enlaces cortos, con un ejemplo de petición y la respuesta devuelta en cada una. Un enlace se designa por su identificador o por su dirección personalizada (slug).

GET/v1/linksListar los enlaces cortos
POST/v1/linksAcortar una dirección
GET/v1/links/{id}Leer un enlace corto
PATCH/v1/links/{id}Modificar un enlace corto
DELETE/v1/links/{id}Eliminar un enlace corto

Listar los enlaces cortos

GET/v1/links

Los enlaces cortos del espacio de trabajo, del más reciente al más antiguo. Ámbito Lectura.

?search=: busca en el destino, la dirección personalizada y el identificador
?tag=: identificador de una etiqueta; solo los enlaces que la llevan
?page= y ?per_page=: paginación, 50 por página por defecto, 100 como máximo

curl "https://api.tinylink.fr/v1/links?search=promo" \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/links?search=promo', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/links?search=promo');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/links?search=promo',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": [
    {
      "id": "6ac401093831b",
      "type": "link",
      "target_url": "https://exemple.fr/promo",
      "slug": "promo",
      "url": "https://tnlnk.fr/promo",
      "status": "active",
      "password_protected": false,
      "restricted": false,
      "tags": [],
      "qr_code": null,
      "created_at": "2026-10-05T21:56:57+02:00",
      "edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 1,
    "total_pages": 1
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Lectura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"read\" scope.",
    "details": {
      "required_scope": "read"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Acortar una dirección

POST/v1/links

url es obligatorio: una dirección web, un correo electrónico o un teléfono. La respuesta es el enlace creado; url es la dirección corta y target_url el destino. Ámbito Escritura.

url: el destino, 500 caracteres como máximo
slug: la dirección personalizada; letras, números, -, _ y ., 40 caracteres como máximo
password: protege el enlace con una contraseña
tags: lista de identificadores de etiquetas del espacio de trabajo
qr_code: true para el código QR clásico, "none" sin logotipo, o el identificador de una plantilla

curl -X POST https://api.tinylink.fr/v1/links \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://exemple.fr/promo",
    "slug": "promo",
    "qr_code": "none"
  }'

const response = await fetch('https://api.tinylink.fr/v1/links', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    url: 'https://exemple.fr/promo',
    slug: 'promo',
    qr_code: 'none',
  }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/links');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'url' => 'https://exemple.fr/promo',
        'slug' => 'promo',
        'qr_code' => 'none',
    ]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/links',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={
        'url': 'https://exemple.fr/promo',
        'slug': 'promo',
        'qr_code': 'none',
    },
)
data = response.json()

Respuestas posibles

{
  "id": "6ac401093831b",
  "type": "link",
  "target_url": "https://exemple.fr/promo",
  "slug": "promo",
  "url": "https://tnlnk.fr/promo",
  "status": "active",
  "password_protected": false,
  "restricted": false,
  "tags": [],
  "qr_code": {
    "png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
    "svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
    "template": "none",
    "shape": "square",
    "encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
  },
  "created_at": "2026-10-05T21:56:57+02:00",
  "edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

Número de enlaces cortos del plan alcanzado

{
  "error": {
    "code": "plan_limit_reached",
    "message": "The link limit of the plan has been reached."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Dirección personalizada ya utilizada por una página o un enlace

{
  "error": {
    "code": "slug_taken",
    "message": "This slug is already taken.",
    "details": {
      "field": "slug"
    }
  }
}

Campo obligatorio ausente o vacío

{
  "error": {
    "code": "validation_failed",
    "message": "The \"url\" field is required (a string).",
    "details": {
      "field": "url"
    }
  }
}

Ni dirección web, ni correo electrónico, ni teléfono

{
  "error": {
    "code": "invalid_url",
    "message": "This is not a valid web address, e-mail address or phone number.",
    "details": {
      "field": "url"
    }
  }
}

Dominio señalado como sospechoso

{
  "error": {
    "code": "suspicious_url",
    "message": "This address is on our list of suspicious domains and cannot be used.",
    "details": {
      "field": "url"
    }
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Leer un enlace corto

GET/v1/links/{id}

status vale active, pending_review (en comprobación, el enlace aún no redirige) o blocked. Ámbito Lectura.

curl https://api.tinylink.fr/v1/links/promo \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/links/promo', {
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/links/promo');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.get(
    'https://api.tinylink.fr/v1/links/promo',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "id": "6ac401093831b",
  "type": "link",
  "target_url": "https://exemple.fr/promo",
  "slug": "promo",
  "url": "https://tnlnk.fr/promo",
  "status": "active",
  "password_protected": false,
  "restricted": false,
  "tags": [],
  "qr_code": {
    "png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
    "svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
    "template": "none",
    "shape": "square",
    "encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
  },
  "created_at": "2026-10-05T21:56:57+02:00",
  "edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Lectura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"read\" scope.",
    "details": {
      "required_scope": "read"
    }
  }
}

Ningún enlace corto con este identificador o este slug en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Link not found in this environment."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Modificar un enlace corto

PATCH/v1/links/{id}

Envía solo los campos que quieras cambiar: url (el destino), slug, password. null quita la dirección personalizada o la contraseña. Cambiar el destino no cambia la dirección corta. Ámbito Escritura.

curl -X PATCH https://api.tinylink.fr/v1/links/6ac401093831b \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/soldes"}'

const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ url: 'https://exemple.fr/soldes' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/links/6ac401093831b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode(['url' => 'https://exemple.fr/soldes']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.patch(
    'https://api.tinylink.fr/v1/links/6ac401093831b',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'url': 'https://exemple.fr/soldes'},
)
data = response.json()

Respuestas posibles

{
  "id": "6ac401093831b",
  "type": "link",
  "target_url": "https://exemple.fr/soldes",
  "slug": "promo",
  "url": "https://tnlnk.fr/promo",
  "status": "active",
  "password_protected": false,
  "restricted": false,
  "tags": [],
  "qr_code": {
    "png": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.png",
    "svg": "https://content.tinylink.fr/QR_Code/QRCode_6ac4011f7a12f.svg",
    "template": "none",
    "shape": "square",
    "encoded_url": "https://tnlnk.fr/6ac401093831b&qr"
  },
  "created_at": "2026-10-05T21:56:57+02:00",
  "edit_url": "https://app.tinylink.fr/shortener-edit?id=6ac401093831b"
}

El cuerpo no es un objeto JSON

{
  "error": {
    "code": "invalid_json",
    "message": "The request body must be a JSON object."
  }
}

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Escritura

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"write\" scope.",
    "details": {
      "required_scope": "write"
    }
  }
}

Ningún enlace corto con este identificador o este slug en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Link not found in this environment."
  }
}

Dirección personalizada ya utilizada por una página o un enlace

{
  "error": {
    "code": "slug_taken",
    "message": "This slug is already taken.",
    "details": {
      "field": "slug"
    }
  }
}

Ningún campo modificable en el cuerpo

{
  "error": {
    "code": "validation_failed",
    "message": "Nothing to update. Accepted fields: url, slug, password."
  }
}

Ni dirección web, ni correo electrónico, ni teléfono

{
  "error": {
    "code": "invalid_url",
    "message": "This is not a valid web address, e-mail address or phone number.",
    "details": {
      "field": "url"
    }
  }
}

Elemento bloqueado por la moderación

{
  "error": {
    "code": "element_blocked",
    "message": "This element is blocked by moderation and can no longer be modified."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Eliminar un enlace corto

DELETE/v1/links/{id}

Elimina el enlace, su código QR y sus estadísticas: la dirección corta deja de redirigir. Irreversible. Ámbito Eliminación.

curl -X DELETE https://api.tinylink.fr/v1/links/6ac401093831b \
  -H "Authorization: Bearer tl_tu_token"

const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer tl_tu_token' },
});
console.log(response.status); // 204

$ch = curl_init('https://api.tinylink.fr/v1/links/6ac401093831b');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer tl_tu_token'],
]);
curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE); // 204
curl_close($ch);

import requests

response = requests.delete(
    'https://api.tinylink.fr/v1/links/6ac401093831b',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
print(response.status_code)  # 204

Respuestas posibles

Sin contenido

Falta el token en la petición

{
  "error": {
    "code": "missing_token",
    "message": "Send your token in the header: Authorization: Bearer tl_…"
  }
}

Token desconocido o revocado

{
  "error": {
    "code": "invalid_token",
    "message": "This token does not exist or has been revoked."
  }
}

El plan del propietario no incluye la API

{
  "error": {
    "code": "plan_required",
    "message": "The TinyLink API is included in the Pro and Business plans. Upgrade the plan of this environment's owner to use it."
  }
}

El token no tiene el ámbito Eliminación

{
  "error": {
    "code": "insufficient_scope",
    "message": "This token does not have the \"delete\" scope.",
    "details": {
      "required_scope": "delete"
    }
  }
}

Ningún enlace corto con este identificador o este slug en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Link not found in this environment."
  }
}

Más de 120 peticiones en el minuto

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: 120 per minute per token."
  }
}

Listar los enlaces cortos

Acortar una dirección

Leer un enlace corto

Modificar un enlace corto

Eliminar un enlace corto

¿No encuentras tu respuesta?