API de clics por grupo (v1)

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

La API suma los clics de todos los enlaces dentro de cada grupo y los devuelve en formato de lista.
Permite comparar varios grupos al mismo tiempo y evaluar el rendimiento de las campañas de forma clara.

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

Documentación v1 (Legacy).

Para nuevas integraciones, recomendamos utilizar la versión más reciente, v2.
v1 está destinada al mantenimiento de integraciones existentes y no recibe nuevas funciones ni mejoras.

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

ymd date required
Fecha de referencia para la consulta. Ejemplo: 2025-08-01
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.