Clics por grupo (v2)

API para consultar el número de clics por grupo de enlaces en una fecha específica.

Devuelve una lista con el total de clics agregados de todos los enlaces dentro de cada grupo.

Se pueden recuperar hasta 30 grupos por solicitud. Para consultar más grupos, utiliza el parámetro pages y llama a la API varias veces.

Esta API está disponible en planes Premium o superiores.

GET

/api/link/v2/clicks-by-group?startYmd={startYmd}&endYmd={endYmd}&grpIdxList={grpIdxList}&pages={pages} 

{
    "startYmd": "2025-08-01",
    "endYmd": "2025-08-31",
    "grpIdxList": "151,207,209",
    "pages": 1
}

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
grpIdxList string

Proporcione la lista de IDX de grupos separados por comas (,). Ejemplo: 151,207,209

  • Plan Premium: Debe especificar la lista de IDX de grupos, hasta 5 grupos permitidos.
  • Plan Business: Si se omite, se consultan los clics de todos los grupos. También se pueden especificar grupos sin límite de cantidad.
pages integer required
Default:1
Número de página de los resultados.
Cada página devuelve 30 resultados por defecto. Ejemplo: si pages=2, se devuelven 30 resultados a partir del registro 31. 
{
    "code": 0,
    "message": "",
    "result": {
        "extra": {
            "pages": 1,
            "nextPages": 1,
            "nextYn": "N",
            "count": 3,
            "totalCount": 3
        },
        "list": [
            {
                "grpIdx": 151,
                "grpNm": "Electronics",
                "acesCnt": 181,
                "pernCnt": 164
            },
            {
                "grpIdx": 207,
                "grpNm": "Kitchenware",
                "acesCnt": 19847,
                "pernCnt": 18095
            },
            {
                "grpIdx": 209,
                "grpNm": "Brian Smith Advertiser Only",
                "acesCnt": 5730,
                "pernCnt": 5409
            }
        ]
    }
}

Response Parameters

code integer
Código de respuesta: 0 = Éxito, otros valores = Error
message string
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
result object
extra object
Información de página y número de datos.
pages integer
Número de la página actual
nextPages integer
Número de la siguiente página
nextYn string
Indica si existe una página siguiente
count integer
Número de registros en la página actual
totalCount integer
Número total de registros
list array
Clics por Grupo
grpIdx integer
Grupo de enlaces (IDX).
grpNm string
Nombre del grupo de enlaces.
acesCnt integer
Número total de clics de todos los enlaces en este grupo.
pernCnt integer
Número de usuarios únicos que hicieron clic en los enlaces de este grupo.