Clicks by Date
This API retrieves daily (YYYY-MM-DD) click counts for a specified period.
The target data varies depending on the request parameters:
- If both link ID + domain are provided, the API returns daily clicks for that specific link.
- If group IDX is included, the API returns the total daily clicks of all links in that group.
- If none of the above are included, the API returns the account-wide daily click statistics.
This API is useful for analyzing how click traffic has changed day by day during the selected period,
and helps with measuring marketing performance, tracking campaign trends, and understanding user traffic patterns.
This API is available from the Personal plan.
Http Header
GET /api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd}
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: -
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"startYmd": "2025-04-01",
"endYmd": "2025-04-30"
}| Fields | Field Descriptions | Description | Required | Type |
|---|---|---|---|---|
| startYmd | Start Date | Example: 2025-04-01 | Date | |
| endYmd | End Date | Example: 2025-04-30 The range between start and end dates can be up to 1 month. | Date | |
| linkId | Link ID | If the link ID contains special characters or Unicode, it must be URL-encoded. For the Personal plan, both the link ID and domain must be included, and only click data for individual links can be retrieved. Starting from the Premium plan, link ID and domain fields are optional. | string | |
| domain | Domain | If the link ID is manually set, the domain is “https://vvd.im” instead of “https://vvd.bz”. Also, if the link was created with a custom domain, you must specify that custom domain in the request to retrieve data correctly. | string | |
| grpIdx | Group IDX | If a group IDX is specified, the total number of clicks from all links within that group will be returned. This field is available starting from the Premium plan. If specified in the Personal plan, it will be ignored. | int |
Response
{
"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
}
]
}| Fields | Description | Type | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | Response code (0: success) | int | ||||||||||||||||
| message | Included when the code is not 0. Contains an error message describing the reason for failure. | string | ||||||||||||||||
| result |
| array |