Etiquetas

Todas las rutas de las etiquetas: su gestión y, después, cómo ponerlas en una página o un enlace corto. Una etiqueta se designa por su identificador numérico.

GET/v1/tagsListar las etiquetas
POST/v1/tagsCrear una etiqueta
GET/v1/tags/{id}Leer una etiqueta
PATCH/v1/tags/{id}Modificar una etiqueta
DELETE/v1/tags/{id}Eliminar una etiqueta
GET/v1/tags/{id}/elementsListar los elementos de una etiqueta
GET/v1/pages/{id}/tagsLeer las etiquetas de un elemento
GET/v1/links/{id}/tagsLeer las etiquetas de un elemento
PUT/v1/pages/{id}/tags/{tag}Poner una etiqueta
PUT/v1/links/{id}/tags/{tag}Poner una etiqueta
DELETE/v1/pages/{id}/tags/{tag}Quitar una etiqueta
DELETE/v1/links/{id}/tags/{tag}Quitar una etiqueta

Listar las etiquetas

GET/v1/tags

Las etiquetas del espacio de trabajo, por orden alfabético. elements_count cuenta las páginas y enlaces que llevan la etiqueta. Ámbito Lectura.

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

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

$ch = curl_init('https://api.tinylink.fr/v1/tags');
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/tags',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": [
    {
      "id": 46,
      "name": "Campaña",
      "color": "#1E90FF",
      "elements_count": 1,
      "created_at": "2026-10-05T21:57:18+02:00"
    }
  ]
}

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

Crear una etiqueta

POST/v1/tags

name es obligatorio (50 caracteres como máximo). color es un color hexadecimal, #1E90FF o #19F; sin él, la etiqueta es negra. Ámbito Escritura.

curl -X POST https://api.tinylink.fr/v1/tags \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"name":"Campaña","color":"#1E90FF"}'

const response = await fetch('https://api.tinylink.fr/v1/tags', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Campaña', color: '#1E90FF' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/tags');
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(['name' => 'Campaña', 'color' => '#1E90FF']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.post(
    'https://api.tinylink.fr/v1/tags',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'name': 'Campaña', 'color': '#1E90FF'},
)
data = response.json()

Respuestas posibles

{
  "id": 46,
  "name": "Campaña",
  "color": "#1E90FF",
  "elements_count": 0,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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

Campo obligatorio ausente o vacío

{
  "error": {
    "code": "validation_failed",
    "message": "The \"name\" field is required.",
    "details": {
      "field": "name"
    }
  }
}

Color que no es hexadecimal

{
  "error": {
    "code": "validation_failed",
    "message": "The \"color\" field must be a hexadecimal colour such as #1E90FF.",
    "details": {
      "field": "color"
    }
  }
}

Más de 120 peticiones en el minuto

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

Leer una etiqueta

GET/v1/tags/{id}

Ámbito Lectura.

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

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

$ch = curl_init('https://api.tinylink.fr/v1/tags/46');
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/tags/46',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "id": 46,
  "name": "Campaña",
  "color": "#1E90FF",
  "elements_count": 1,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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 una etiqueta

PATCH/v1/tags/{id}

name, color, o ambos. Ámbito Escritura.

curl -X PATCH https://api.tinylink.fr/v1/tags/46 \
  -H "Authorization: Bearer tl_tu_token" \
  -H "Content-Type: application/json" \
  -d '{"name":"Campaña de verano"}'

const response = await fetch('https://api.tinylink.fr/v1/tags/46', {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer tl_tu_token',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Campaña de verano' }),
});
const data = await response.json();

$ch = curl_init('https://api.tinylink.fr/v1/tags/46');
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(['name' => 'Campaña de verano']),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

import requests

response = requests.patch(
    'https://api.tinylink.fr/v1/tags/46',
    headers={'Authorization': 'Bearer tl_tu_token'},
    json={'name': 'Campaña de verano'},
)
data = response.json()

Respuestas posibles

{
  "id": 46,
  "name": "Campaña de verano",
  "color": "#1E90FF",
  "elements_count": 1,
  "created_at": "2026-10-05T21:57:18+02:00"
}

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

Ninguna etiqueta con este identificador en el espacio de trabajo

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

Ningún campo modificable en el cuerpo

{
  "error": {
    "code": "validation_failed",
    "message": "Nothing to update. Accepted fields: name, color."
  }
}

Color que no es hexadecimal

{
  "error": {
    "code": "validation_failed",
    "message": "The \"color\" field must be a hexadecimal colour such as #1E90FF.",
    "details": {
      "field": "color"
    }
  }
}

Más de 120 peticiones en el minuto

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

Eliminar una etiqueta

DELETE/v1/tags/{id}

Elimina la etiqueta y la quita de todos los elementos que la llevaban; las páginas y los enlaces en sí no se tocan. Ámbito Eliminación.

curl -X DELETE https://api.tinylink.fr/v1/tags/46 \
  -H "Authorization: Bearer tl_tu_token"

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

$ch = curl_init('https://api.tinylink.fr/v1/tags/46');
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/tags/46',
    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"
    }
  }
}

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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 elementos de una etiqueta

GET/v1/tags/{id}/elements

Las páginas y los enlaces cortos que llevan la etiqueta, paginados como las demás listas (?page=, ?per_page=). type distingue page y link. Ámbito Lectura.

curl https://api.tinylink.fr/v1/tags/46/elements \
  -H "Authorization: Bearer tl_tu_token"

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

$ch = curl_init('https://api.tinylink.fr/v1/tags/46/elements');
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/tags/46/elements',
    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": [
        {
          "id": 46,
          "name": "Campaña",
          "color": "#1E90FF"
        }
      ],
      "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"
    }
  }
}

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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."
  }
}

Leer las etiquetas de un elemento

GET/v1/pages/{id}/tags

GET/v1/links/{id}/tags

Las etiquetas puestas en una página o en un enlace corto. Ámbito Lectura.

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

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

$ch = curl_init('https://api.tinylink.fr/v1/links/6ac401093831b/tags');
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/6ac401093831b/tags',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": [
    {
      "id": 46,
      "name": "Campaña",
      "color": "#1E90FF"
    }
  ]
}

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

Ninguna página con este identificador o este slug en el espacio de trabajo

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

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

Poner una etiqueta

PUT/v1/pages/{id}/tags/{tag}

PUT/v1/links/{id}/tags/{tag}

Pone la etiqueta en la página o el enlace corto; sin cuerpo de petición. La respuesta da las etiquetas del elemento tras la operación. Ámbito Escritura.

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

const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b/tags/46', {
  method: 'PUT',
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

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

import requests

response = requests.put(
    'https://api.tinylink.fr/v1/links/6ac401093831b/tags/46',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": [
    {
      "id": 46,
      "name": "Campaña",
      "color": "#1E90FF"
    }
  ]
}

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

Ninguna página con este identificador o este slug en el espacio de trabajo

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

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

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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."
  }
}

Quitar una etiqueta

DELETE/v1/pages/{id}/tags/{tag}

DELETE/v1/links/{id}/tags/{tag}

Quita la etiqueta del elemento sin eliminar nada: basta con el ámbito Escritura. La respuesta da las etiquetas restantes.

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

const response = await fetch('https://api.tinylink.fr/v1/links/6ac401093831b/tags/46', {
  method: 'DELETE',
  headers: { Authorization: 'Bearer tl_tu_token' },
});
const data = await response.json();

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

import requests

response = requests.delete(
    'https://api.tinylink.fr/v1/links/6ac401093831b/tags/46',
    headers={'Authorization': 'Bearer tl_tu_token'},
)
data = response.json()

Respuestas posibles

{
  "data": []
}

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

Ninguna página con este identificador o este slug en el espacio de trabajo

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

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

Ninguna etiqueta con este identificador en el espacio de trabajo

{
  "error": {
    "code": "not_found",
    "message": "Tag 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 las etiquetas

Crear una etiqueta

Leer una etiqueta

Modificar una etiqueta

Eliminar una etiqueta

Listar los elementos de una etiqueta

Leer las etiquetas de un elemento

Poner una etiqueta

Quitar una etiqueta

¿No encuentras tu respuesta?