Clics por grupo

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/v1/clicks-by-group?ymd={ymd}&grpIdxList={grpIdxList}&pages={pages}

{
    "ymd": "2025-08-01",
    "grpIdxList": "151,207,209",
    "pages": 1
}

Request Parameters

ymddaterequired
Fecha de referencia para la consulta. Ejemplo: 2025-08-01
grpIdxListstring

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.
pagesintegerrequired
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

codeinteger
Código de respuesta: 0 = Éxito, otros valores = Error
messagestring
Mensaje de respuesta. Si el código no es 0, se devuelve un mensaje de error.
resultobject
extraobject
Información de página y número de datos.
pagesinteger
Número de la página actual
nextPagesinteger
Número de la siguiente página
nextYnstring
Indica si existe una página siguiente
countinteger
Número de registros en la página actual
totalCountinteger
Número total de registros
listarray
Clics por Grupo
grpIdxinteger
Grupo de enlaces (IDX).
grpNmstring
Nombre del grupo de enlaces.
acesCntinteger
Número total de clics de todos los enlaces en este grupo.
pernCntinteger
Número de usuarios únicos que hicieron clic en los enlaces de este grupo.