Hourly Click Analytics API (v2)

Retrieve hourly click counts (00:00–23:59) for a selected date range.

Analyze hourly traffic distribution for a specific link, group, or your entire account.
Use it to measure campaign performance, identify peak engagement hours, and understand user activity patterns.

This API is available on the Personal plan and above.

v2 (Legacy) documentation.

For new integrations, we recommend using the latest version, v3.
v2 is intended for maintaining existing integrations and does not receive new features or improvements.

GET

/api/statistics/v2/clicks-by-hour?ymd={ymd} 

{
    "ymd": "2025-04-20"
}

Request Parameters

ymd date required
Reference date for the query. Example: 2025-04-20
linkId string
Link ID. If it contains special characters or Unicode, URL encoding is required.
Personal plan: linkId and domain are required, only individual link clicks can be retrieved.
Premium plans or higher: optional input.
domain string
Link domain.
grpIdx integer
Link group. The group IDX can be obtained by calling the Group List API or checking in the dashboard.
If specified, the total click count of all links in that group will be returned. Available only on Premium plans or higher. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-20",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-20",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-20",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-20",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-20",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-20",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

codeinteger
Response code: 0 = Success, any other value = Error
messagestring
Response message. If the response code is not 0, an error-related message is returned.
resultarray
ymddate
Date.
hourinteger
Hour (0–23).
acesCntinteger
Total clicks during the specified time period.
pernCntinteger
Number of unique users who clicked links during that time period.