Clicks by Date
This API allows you to retrieve the number of daily clicks for a specific short link.
You can use it to analyze daily traffic trends over a period and evaluate marketing performance.
This API is available on the Business plan and higher.
Http Header
GET /api/statistics/v1/clicks-by-date?linkId={linkId}&domain={domain}&startYmd={startYmd}&endYmd={endYmd}
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: -
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"linkId": "kYdr",
"domain": "https://vvd.bz",
"startYmd": "2025-04-01",
"endYmd": "2025-04-30"
}| Fields | Field Descriptions | Description | Required | Type |
|---|---|---|---|---|
| linkId | Link ID | If the Link ID contains special characters or Unicode, URLEncode is required. | string | |
| domain | Domain | If the Link ID was manually set, the domain will be “https://vvd.im” instead of “https://vvd.bz”. | string | |
| startYmd | Start Date | Example: 2025-04-01 | Date | |
| endYmd | End Date | The range between start and end dates must not exceed one month. Example: 2025-04-30 | Date |
Response
{
"code": 0,
"message": "",
"result": [
{
"ymd": "2025-04-01",
"linkId": "kYdr",
"domain": "https://vvd.bz",
"acesCnt": 384,
"pernCnt": 295
},
{
"ymd": "2025-04-02",
"linkId": "kYdr",
"domain": "https://vvd.bz",
"acesCnt": 1785,
"pernCnt": 1720
},
{
"ymd": "2025-04-03",
"linkId": "kYdr",
"domain": "https://vvd.bz",
"acesCnt": 19542,
"pernCnt": 19083
},
{
"ymd": "2025-04-04",
"linkId": "kYdr",
"domain": "https://vvd.bz",
"acesCnt": 3596,
"pernCnt": 3274
},
{
"ymd": "2025-04-05",
"linkId": "kYdr",
"domain": "https://vvd.bz",
"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 |