Acortador de links con API REST: guía para devs 2026
Si estás construyendo una app, un bot, o cualquier sistema que necesite generar links cortos programáticamente, necesitás un acortador con API REST. Acá te muestro qué endpoints ofrece Acortalink, cómo autenticar y cuánto cuesta.
Endpoints de la API
| Método | Endpoint | Descripción |
|---|---|---|
POST | /api/v1/links/ | Crear link acortado |
GET | /api/v1/links/ | Listar links del usuario |
GET | /api/v1/links/<code>/ | Detalle de un link |
DELETE | /api/v1/links/<code>/ | Eliminar link |
GET | /api/v1/stats/<code>/ | Analytics de un link |
POST | /api/v1/keys/ | Crear API key |
GET | /api/v1/keys/ | Listar API keys |
Autenticación
La API usa header X-API-Key. Generá tu key desde el dashboard:
curl -X POST https://app.acortalink.com.ar/api/v1/links/ \
-H "X-API-Key: tu-api-key-aqui" \
-H "Content-Type: application/json" \
-d '{"url": "https://ejemplo.com/pagina-muy-larga"}'
Respuesta:
{
"link": {
"short_code": "abc123",
"short_url": "https://app.acortalink.com.ar/s/abc123/",
"original_url": "https://ejemplo.com/pagina-muy-larga",
"is_premium": true,
"clicks": 0,
"has_seo": false,
"has_password": false,
"created_at": "2026-01-15T12:00:00Z",
"qr_url": "https://app.acortalink.com.ar/qr/abc123/"
},
"created": true
}
Deduplicación automática
Si mandás la misma URL dos veces, la API no crea un link nuevo. Devuelve el link existente con "created": false. Esto evita duplicados sin que tengas que manejarlo del lado del cliente.
Rate limiting
| Plan | Requests/mes | Precio |
|---|---|---|
| Starter | 1.000 | $4.900 ARS/mes |
| Pro | 5.000 | $9.800 ARS/mes |
| Business | 25.000 + webhooks | $28.000 ARS/mes |
Cuando alcanzás el límite, la API devuelve HTTP 429 con headers:
HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 1000
X-RateLimit-Used: 1001
{"error": "Límite de API alcanzado (1001/1000 req/mes). Considerá upgradear tu plan."}
Webhooks (Business)
El plan Business incluye webhooks para eventos:
link.created— cuando se crea un linklink.deleted— cuando se elimina un linkclick— cuando un link recibe un click
Configurá tu endpoint desde el dashboard y Acortalink envía un POST firmado con cada evento.
Comparativa de APIs
| Acortador | API | Rate limit | Webhooks | Precio |
|---|---|---|---|---|
| Acortalink | REST | 1.000-25.000/mes | Business | $4.900 ARS |
| Bitly | REST | Limitado | No | $29 USD |
| Dub.co | REST | Limitado | Sí | ~$90 USD |
| Short.io | REST | Limitado | Sí | $5 USD |
| TinyURL | No | - | No | $9.99 USD |
Casos de uso de la API
Bot de Telegram
Un bot que recibe URLs largas y devuelve links cortos. Ideal para grupos de Telegram donde se comparten muchos links.
Auto-posting en redes sociales
Tu script de posting automaticamente acorta cada URL antes de publicar. Con analytics, sabés qué posts generan más clicks.
E-commerce
Generar links cortos automáticamente para cada producto. Cuando cambiás la URL del producto, el link corto se actualiza sin tocar el frontend.
Email marketing
Acortar cada link de tu newsletter con un slug único. Sabés exactamente qué link generó más clicks.
API REST lista para integrar
1.000 req/mes desde $4.900 ARS · Webhooks en Business · MercadoPago
Crear cuenta →