API de clics por hora (v3)

Consulta el número de clics por hora (00:00–23:59) dentro de un rango de fechas.

Analiza la distribución de tráfico por hora para enlaces, grupos o toda la cuenta.
Permite medir campañas, identificar horas clave y comprender el comportamiento de los usuarios.

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

GET

/api/statistics/v3/clicks-by-hour?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

startYmd date required
Fecha de inicio de la consulta (ej.: 2025-12-01)
endYmd date required
Fecha de finalización de la consulta (ej.: 2025-12-31). El rango máximo entre la fecha de inicio y la de finalización es de 1 mes.
Plan Personal: hasta 7 días
Plan Premium: hasta 14 días
linkId string
ID del enlace. Si contiene caracteres especiales o Unicode, se requiere codificación URL.
Plan Personal: linkId y dominio obligatorios, solo se pueden consultar los clics de un enlace individual.
Planes Premium o superiores: entrada opcional.
domain string
Dominio del enlace.
grpIdx integer
Grupo de enlaces. El IDX del grupo puede obtenerse llamando al API de Lista de Grupos o verificándolo en el panel de control.
Si se especifica, se devuelve el total de clics de todos los enlaces del grupo. Disponible solo en planes Premium o superiores. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-01",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-02",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-03",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-04",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-05",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-10",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

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
ymddate
Fecha.
hourinteger
Hora (0–23).
acesCntinteger
Número total de clics durante el período de tiempo especificado.
pernCntinteger
Número de usuarios únicos que hicieron clic en enlaces durante ese período.

Cuándo usar esta API

Utiliza esta API para identificar en qué momentos del día se concentran los clics.

Permite optimizar horarios de campañas, programar anuncios y analizar el comportamiento de los usuarios según el tiempo.

Puedes analizar un enlace específico o datos agregados por grupo.
Va más allá de la estadística y permite análisis de comportamiento basado en el tiempo.

Cómo definir el alcance de la consulta

Puedes definir el alcance de la consulta de tres maneras.

Envía linkId y domain para obtener clics por hora de un enlace específico.
Envía grpIdx para obtener clics agregados de todos los enlaces del grupo.
Si no se especifica ninguno, se devuelven los datos de toda la cuenta.

Funciones clave y métricas de análisis

Esta API proporciona datos analíticos por hora, no solo el número de clics.

Clics por hora (accsCnt)

  • Total de clics por cada hora
  • Identificación de horas pico de tráfico

Usuarios únicos (pernCnt)

  • Número de usuarios únicos por hora
  • Análisis de la relación entre clics y usuarios

La comparación entre clics y usuarios permite detectar clics duplicados y patrones de comportamiento.

Casos de uso

  • Optimización de campañas: Enviar en las horas con mayor volumen según datos históricos
  • Programación de anuncios: Ajustar horarios según accsCnt
  • Análisis de usuarios: Identificar horas de mayor adquisición con pernCnt
  • Análisis por grupo: Evaluar el rendimiento por hora usando grpIdx

Aspectos a tener en cuenta

  • startYmd y endYmd son parámetros obligatorios y deben seguir el formato yyyy-MM-dd.
  • El rango máximo de fechas depende del plan. Si se supera el límite, se devolverá un error.
  • Si linkId contiene caracteres especiales o Unicode, aplica codificación URL.
  • El número de clics y de usuarios puede no coincidir.