Clics por hora

API para consultar los clics por hora de una fecha específica (00:00–23:59).

Condiciones de consulta

  • linkId + domain especificados → Consulta de clics por hora de ese enlace.
  • grpIdx especificado → Consulta del total de clics por hora de los enlaces del grupo.
  • Sin condición → Consulta de clics por hora de toda la cuenta.

Esta API se utiliza para analizar la distribución del tráfico de clics en una fecha determinada.
Útil para medir el rendimiento de eventos, identificar las horas pico de marketing y analizar patrones de actividad de los usuarios.

Esta API está disponible en planes Personales o superiores.

GET

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

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

Request Parameters

ymddaterequired
Fecha de referencia para la consulta. Ejemplo: 2025-04-20
linkIdstring
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.
domainstring
Dominio del enlace.
grpIdxinteger
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.