날짜별 클릭 수
지정한 단축 링크의 날짜별 클릭 수를 조회할 수 있는 API입니다.
이 API를 사용하면 기간에 따른 일간 트래픽 추이를 분석하고 마케팅 성과를 평가할 수 있습니다.
이 API는 비즈니스 요금제부터 사용할 수 있습니다.
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"
}| 필드 | 필드 설명 | 설명 | 필수 | 유형 |
|---|---|---|---|---|
| linkId | 링크 ID | 링크 ID에 특수문자 및 유니코드가 포함되어 있을 경우, URLEncode가 필요합니다. | string | |
| domain | 도메인 | 링크 ID를 직접 설정한 경우 도메인은 “https://vvd.bz”가 아닌 “https://vvd.im” 입니다. | string | |
| startYmd | 시작 날짜 | 예: 2025-04-01 | Date | |
| endYmd | 종료 날짜 | 시작 날짜와 종료 날짜 범위는 최대 1달입니다. 예: 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
}
]
}| 필드 | 설명 | 유형 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | 응답 코드 (0:성공) | int | ||||||||||||||||||||||||
| message | code가 0이 아닌 경우에 포함되며, 실패 원인을 설명하는 오류 메시지가 담겨 있습니다. | string | ||||||||||||||||||||||||
| result |
| array |