Clics por fecha
API para consultar los clics diarios (YYYY-MM-DD) en un período específico.
Condiciones de consulta
- linkId + domain especificados → Consulta de clics diarios de ese enlace.
- grpIdx especificado → Consulta del total de clics diarios de los enlaces en ese grupo.
- Sin condición → Consulta de clics diarios de toda la cuenta.
Esta API es útil para analizar los cambios en el tráfico de clics durante un período determinado.
Se puede utilizar para medir el rendimiento de marketing, identificar tendencias de campaña y analizar la evolución de la captación de usuarios.
Esta API está disponible en planes Personales o superiores.
GET
/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd}
{
"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.