GET/api/v6/urlshortener/links/{domain}/{code}/stats

Estadísticas del enlace

Totales, serie de tiempo y desgloses por país, dispositivo o referente.

Alcance

API key con el servicio urlshortener habilitado

Límite de uso

120 solicitudes por minuto

La granularidad por hora solo está disponible para rangos de 31 días o menos, dentro de los últimos 90 días.

Analítica de clics de un enlace: totales, una serie de tiempo y desgloses top-N por dimensión. Los cortes de día y hora se calculan en America/Bogota.

uniqueClicks sumado sobre un rango de varios días es una aproximación: los únicos se deduplican por día.

Parámetros de ruta

domain

stringobligatorio

Dominio del enlace.

code

stringobligatorio

Código corto o alias (en minúsculas).

Parámetros de consulta

range

stringopcional

Ventana predefinida. Se ignora si envías from o to.

last_24hlast_7dlast_30dlast_90dthis_monthlast_monthytdall_time

Por defecto: last_30d

from

stringopcional

Inicio de una ventana personalizada (ISO-8601).

to

stringopcional

Fin de la ventana personalizada (ISO-8601). Por defecto, ahora.

granularity

stringopcional

Automática si se omite.

hourday

dimensions

stringopcional

Dimensiones de desglose separadas por coma: country, subdivision, city, device, os, browser, referrer.

Respuestas

200

Analítica del enlace.

{
  "success": true,
  "data": {
    "code": "a1b2c3d",
    "domain": "go.acme.co",
    "range": {
      "from": "2026-05-03T00:00:00-05:00",
      "to": "2026-06-01T18:30:00-05:00",
      "granularity": "day"
    },
    "totals": {
      "clicks": 128,
      "uniqueClicks": 96,
      "firstClickAt": "2026-05-04T12:00:00Z",
      "lastClickAt": "2026-06-01T18:22:10Z"
    },
    "series": [{ "ts": "2026-05-04", "clicks": 40, "uniqueClicks": 31 }],
    "breakdowns": {
      "country": [{ "key": "CO", "clicks": 90 }, { "key": "__other", "clicks": 38 }],
      "device": [{ "key": "mobile", "clicks": 110 }]
    }
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-01T18:30:00+00:00",
    "responseTimeMs": 9.4
  }
}

400

Rango o granularidad inválidos.

401

Credenciales inválidas o faltantes.

404

No existe un enlace con ese dominio y código.

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.

401AUTH_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.400STATS_RANGE_INVALIDEl rango o la granularidad de estadísticas son inválidos.404LINK_NOT_FOUNDNo hay un enlace con ese dominio y código.429RATE_TPS_EXCEEDEDExcediste el cupo de tu organización para este endpoint.

Ver el catálogo completo

Alcance y límites

Parámetros de ruta

Parámetros de consulta

Respuestas

Errores posibles