API de clics mensuales

Consulta el número de clics por mes (YYYY-MM) dentro de un rango de fechas.

Analiza tendencias de tráfico a largo plazo y patrones de crecimiento para evaluar el rendimiento de campañas y el comportamiento de los usuarios.

Esta API está disponible en el plan Personal o superior.

GET

/api/statistics/v1/clicks-by-month?startYm={startYm}&endYm={endYm} 


GET /api/statistics/v1/clicks-by-month
     ?startYm=2026-01
     &endYm=2026-04

Request Parameters

startYm string required
Año y mes de inicio. Usa el formato YYYY-MM. Ejemplo: 2026-01
endYm string required
Año y mes de fin. Usa el formato YYYY-MM. Ejemplo: 2026-04
El rango permitido depende del plan.
Personal: últimos 90 días
Premium: últimos 180 días
Business: últimos 365 días
linkId string
ID del enlace. Si contiene caracteres especiales o Unicode, debes aplicar codificación URL.
Personal: linkId y domain obligatorios. Solo se pueden consultar enlaces individuales.
Premium o superior: opcional.
domain string
Dominio del enlace. También se admiten dominios personalizados.
grpIdx integer
ID del grupo. Puedes obtenerlo desde la API de grupos o el panel.
Si se especifica, se devuelve el total de clics de todos los enlaces del grupo.
Disponible en Premium o superior. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ym": "2026-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2026-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2026-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2026-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        }
    ]
}

Response Parameters

codeinteger
Código de respuesta: 0 = Éxito, cualquier otro valor = Error
messagestring
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje relacionado con el error.
resultarray
ym string
Año y mes, devuelto en formato YYYY-MM. Ejemplo: 2026-01
acesCnt integer
Número total de clics del mes especificado.
pernCnt integer
Número de usuarios únicos que hicieron clic en el enlace durante ese mes.

Cuándo usar esta API

Utiliza esta API para analizar tendencias de tráfico de enlaces a nivel mensual.

Es ideal para resumir el rendimiento de campañas trimestrales o semestrales, analizar patrones estacionales y preparar informes anuales.

En comparación con la API de clics por fecha, permite un análisis de tendencias a largo plazo.

Diferencia con la API de clics por fecha

La API de clics por fecha agrega datos por día y es adecuada para análisis a corto plazo, mientras que la API mensual agrega por mes y es más útil para análisis a largo plazo.
Además, según el plan, permite consultas de hasta 365 días, lo que la hace adecuada para análisis anuales.
※ Los planes Business Plus y Enterprise pueden admitir hasta 2 años según contrato

Límites de consulta por plan

Esta API está disponible a partir del plan Personal. El rango de consulta varía según el plan.

El plan Personal permite hasta 90 días, Premium hasta 180 días y Business hasta 365 días.
Las consultas por grupo mediante grpIdx están disponibles solo en Premium o superior.

Métricas y análisis

Esta API proporciona datos agregados mensuales.

Clics mensuales (accsCnt)

  • Total de clics del mes
  • Seguimiento de tendencias de crecimiento o disminución

Usuarios (pernCnt)

  • Número de usuarios únicos del mes
  • Medición del volumen real de tráfico

Estos indicadores permiten analizar el crecimiento, los patrones estacionales y el rendimiento a largo plazo.

Casos de uso

  • Informes trimestrales: Define el período con startYm y endYm para analizar tendencias mensuales
  • Análisis estacional: Consulta un año de datos para identificar los meses con mayor tráfico
  • Tendencias de campañas: Usa grpIdx para analizar el comportamiento mensual de un grupo
  • Informes anuales: Con el plan Business, recopila hasta 365 días de datos para informes anuales

Aspectos a tener en cuenta

  • startYm y endYm son obligatorios y deben seguir el formato YYYY-MM.
  • El rango máximo depende del plan. Superarlo devolverá un error.
  • Si linkId contiene caracteres especiales o Unicode, se requiere codificación URL.
  • Esta API está disponible desde el plan Personal. Verifica tu plan antes de usarla.