API de clics por hora (v2)

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.

Documentación v2 (Legacy).

Para nuevas integraciones, recomendamos utilizar la versión más reciente, v3.
v2 está destinada al mantenimiento de integraciones existentes y no recibe nuevas funciones ni mejoras.

GET

/api/statistics/v2/clicks-by-hour?ymd={ymd} 

{
    "ymd": "2025-04-20"
}

Request Parameters

ymd date required
Fecha de referencia para la consulta. Ejemplo: 2025-04-20
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-20",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-20",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-20",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-20",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-20",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-20",
            "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.