GET
/api/v6/urlshortener/linksListar enlaces cortos
Tus enlaces del más nuevo al más viejo, con sus contadores de clics. Paginado.
Alcance y límites
Alcance
API key con el servicio urlshortener habilitado
Límite de uso
30 solicitudes por minuto
- Hasta 100 ítems por página.
Lista tus enlaces cortos, del más nuevo al más viejo, con los contadores de clics ya consolidados en cada ítem.
Parámetros de consulta
pageintegeropcional
Número de página (empieza en 1).
Por defecto: 1
perPageintegeropcional
Ítems por página (máximo 100).
Por defecto: 20
activebooleanopcional
Filtra por estado activo.
domainstringopcional
Filtra por dominio.
searchstringopcional
Coincidencia por subcadena en el código o la URL de destino (mínimo 2 caracteres).
Respuestas
200
Página de enlaces.
{
"success": true,
"data": {
"items": [
{
"id": 1024,
"code": "a1b2c3d",
"domain": "go.acme.co",
"shortUrl": "https://go.acme.co/a1b2c3d",
"longUrl": "https://example.com/landing",
"active": true,
"expiresAt": null,
"createdAt": "2026-06-01T15:04:05Z",
"clicks": 128,
"uniqueClicks": 96,
"lastClickAt": "2026-06-01T18:22:10Z"
}
],
"page": 1,
"perPage": 20,
"total": 1,
"hasMore": false
},
"meta": {
"requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
"timestamp": "2026-06-01T18:30:00+00:00",
"responseTimeMs": 5.1
}
}401
Credenciales inválidas o faltantes.
429
Se excedió el límite de solicitudes.
Errores posibles
Códigos que este endpoint puede devolver en error.code. El detalle completo está en el catálogo.
401
Ver el catálogo completoAUTH_REQUIREDNo se envió un token Bearer y cada llamada lo requiere.401AUTH_INVALID_KEYLa API key no se reconoce: formato equivocado, revocada o vencida.401AUTH_SERVICE_NOT_ALLOWEDLa key no tiene permitido el servicio detrás de este endpoint.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.