Clicks by Date
API to retrieve daily clicks (YYYY-MM-DD) for a specified period.
Query conditions
- Both linkId + domain specified → Retrieve daily clicks for that link.
- grpIdx specified → Retrieve total daily clicks for links in that group.
- No condition → Retrieve daily clicks for the entire account.
This API is useful for analyzing changes in click traffic during a given period.
It can be used for measuring marketing performance, identifying campaign trends, and analyzing user acquisition flows.
This API is available on Personal plans or higher.
GET
/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd}
{
"startYmd": "2025-04-01",
"endYmd": "2025-04-30"
}
Request Parameters
- startYmddaterequired
- Query start date (e.g., 2025-04-01)
- endYmddaterequired
- Query end date (e.g., 2025-04-30). The maximum range between start and end date is 1 month.
- linkIdstring
- 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.
- domainstring
- Link domain.
- grpIdxinteger
- 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-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
- 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.
- acesCntinteger
- Total clicks on the specified date.
- pernCntinteger
- Number of unique users who clicked links on that date.