API de clics diarios (v2)

Consulta el número de clics por día (YYYY-MM-DD) dentro de un rango de fechas.

Analiza la evolución diaria del tráfico para enlaces, grupos o toda la cuenta.
Permite medir campañas, identificar tendencias y analizar la adquisición de usuarios.

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

GET

/api/statistics/v2/clicks-by-date?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 (ejemplo: 2025-04-01)
endYmd date required
Fecha de finalización de la consulta (ej.: 2025-04-30). 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",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2025-04-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2025-04-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2025-04-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        },
        {
            "ymd": "2025-04-05",
            "acesCnt": 171,
            "pernCnt": 164
        }
    ]
}

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.
acesCntinteger
Número total de clics en la fecha especificada.
pernCntinteger
Número de usuarios únicos que hicieron clic en enlaces en esa fecha.

Cuándo usar esta API

Utiliza esta API para entender cómo cambian los clics por día a lo largo del tiempo.

Permite comparar tráfico antes y después de campañas, analizar patrones semanales y evaluar el impacto de eventos.

Va más allá de un simple conteo y permite análisis de tendencias en el tiempo.

Diferencia con la API de clics por hora

La API de clics por hora agrupa datos por hora (0–23), mientras que esta API lo hace por día.

Usa la API por hora para analizar comportamiento dentro de un día y la API diaria para entender tendencias a lo largo de varios días o semanas.

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 diarios 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 diarios de toda la cuenta.

Funciones clave y métricas de análisis

Esta API proporciona datos agregados por día.

Clics diarios (accsCnt)

  • Total de clics por fecha
  • Identificación de aumentos o caídas de tráfico

Usuarios únicos (pernCnt)

  • Número de usuarios únicos por fecha
  • Análisis del comportamiento de usuarios en relación con los clics

Estos datos permiten entender tendencias de crecimiento, rendimiento de campañas y patrones de clics repetidos.

Casos de uso

  • Medición de campañas: Define el periodo con startYmd y endYmd para analizar tendencias diarias
  • Análisis por día de la semana: Consulta datos semanales para identificar los días con mayor actividad
  • Comparación de eventos: Compara el tráfico antes y después de un evento
  • Detección de tráfico anómalo: Analiza picos de clics en fechas específicas

Aspectos a tener en cuenta

  • El rango máximo de fechas depende del plan. Superarlo generará un error.
  • Los datos diarios no incluyen desglose por horas.
  • Si linkId contiene caracteres especiales o Unicode, aplica codificación URL.
  • En el plan Personal, es obligatorio enviar linkId y domain juntos.