1. Inicio
  2. Integraciones
  3. API REST

API REST

La API REST completa para automatizar todos tus enlaces y códigos QR

Cada pantalla de TinyLink tiene sus rutas: enlaces cortos, UTM, programación, códigos QR, páginas, componentes, etiquetas y estadísticas. Tus scripts, tu CRM y tus escenarios de Make, Zapier o n8n crean en una petición lo que antes costaba diez clics. La documentación da un ejemplo de petición y de respuesta para cada ruta.

API incluida desde el plan Pro, a 29 € sin IVA al mes, sin permanencia. Gratis para empezar, sin tarjeta bancaria.

Lo que cuestan los enlaces hechos a mano

Copiar la dirección, montar los UTM, acortar, generar el código QR, descargarlo, guardarlo: cuenta dos minutos por enlace. En un catálogo de 300 productos, es un día entero, que hay que repetir en cada campaña. Y una errata en un utm_campaign basta para partir tus estadísticas en dos.

Una ruta para cada gesto

Lo que haces en el panel, la API también lo hace, con las mismas reglas y los mismos límites que tu plan. Una sola petición POST /v1/links crea el enlace corto, sus UTM, su fecha de fin y su código QR dinámico. Para reaccionar cuando un enlace caduca, añade alertas automáticas por webhooks; para crear enlaces desde una conversación, el servidor MCP oficial para Claude.

  • Enlaces cortos: dirección personalizada, UTM, plantillas UTM compartidas, programación y número máximo de clics
  • Códigos QR dinámicos: creados con el enlace, con o sin logo, o desde tus plantillas
  • Páginas y componentes: crear, editar y duplicar una página, y añadirle tus bloques
  • Estadísticas: clics por día, procedencia, países y dispositivos, de 1 a 90 días o desde la creación

Ver los precios

Un agente de IA recibe la petición «Crea el enlace de la campaña de primavera, UTM newsletter, fin el 31 de marzo» y llama a POST /v1/links con la dirección, la dirección corta, los UTM, la fecha de fin y el código QR. La API responde 201 en 87 ms: tnlnk.fr/primavera, programado hasta el 31 de marzo, con su código QR. Alrededor, el token y sus permisos, y el límite de 120 peticiones por minuto.

Tokens bajo control

Un token por espacio, con sus permisos: lectura, escritura, eliminación. Solo abre el espacio donde se generó, se guarda cifrado en nuestros servidores y se regenera o se revoca con un clic. Cada respuesta indica las peticiones que quedan en el minuto (120 por token): tus scripts saben cuándo frenar.

Ver los webhooks

El selector de espacios está abierto: Studio Martin es el espacio activo, el cursor pasa por Agence Nord y Maison Olea espera debajo. Detrás, dos espacios con contenidos separados: 12 páginas y 48 enlaces para Agence Nord, 7 páginas y 21 enlaces para Maison Olea. Alrededor, los espacios están aislados y uno nuevo se crea con un clic.

Alojada en Francia, lista para tus clientes

La API, tus enlaces y las estadísticas de tus visitantes se quedan en servidores franceses. Con el plan Business, cada cliente de agencia tiene su propio espacio y su propio token: un script mal configurado en uno nunca toca los enlaces del otro. Los errores llegan en JSON, con un código y el campo en cuestión.

Aplicación francesa

La tarjeta de estado de la infraestructura de TinyLink: sitio, aplicación, base de datos y redirecciones de los enlaces cortos, todo en línea y en Francia, en o2switch. Al lado, un punto luminoso sobre Clermont-Ferrand. Alrededor, HTTPS en todo el servicio, secretos cifrados en AES-256-GCM y datos ni vendidos ni alquilados.

Un catálogo de 300 productos, con sus enlaces y códigos QR en minutos

Una tienda online prepara sus etiquetas de estantería. Su script recorre el catálogo y llama a POST /v1/links para cada ficha de producto: enlace corto con su nombre, UTM «tienda», código QR creado en la misma petición. Menos de tres minutos después, a 120 peticiones por minuto, los 300 códigos QR están listos para imprimir, y cada escaneo aparece en las estadísticas, producto por producto.

Preguntas frecuentes

¿Con qué plan está disponible la API?

Desde el plan Pro, a 29 € sin IVA al mes, sin permanencia, con 5 espacios de trabajo. El plan Business, a 79 € sin IVA al mes, llega hasta 25, cada uno con su propio token.

¿Qué lenguajes y herramientas puedo usar?

Cualquiera que sepa enviar una petición HTTPS con una cabecera Authorization: Python, PHP, JavaScript, curl, y también el módulo de petición HTTP de Make, Zapier o n8n. Las respuestas están en JSON.

¿Hay un límite de peticiones?

120 peticiones por minuto y por token. Cada respuesta lleva las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset; pasado el límite, la API responde 429 con el tiempo de espera. Los límites de tu plan (páginas, enlaces) se aplican igual que en el panel.

¿Mis datos y mis tokens están seguros?

Tus datos están alojados en Francia y se aplica el RGPD. Cada token solo abre su espacio, con los permisos que elijas; se guarda cifrado y se revoca en cualquier momento. El panel del token muestra la fecha de la última llamada y el número de llamadas.

Enlaces creados por tus herramientas, no a mano

Crea tu cuenta, pasa al plan Pro y genera tu token en Biblioteca ▸ Integraciones. Tu primer enlace por la API cabe en una petición.