시간대별 클릭 수
지정한 링크의 하루 동안 시간대별(0시 ~ 23시) 클릭 수를 조회하는 API입니다.
이 API를 사용하면 특정 날짜에 어떤 시간대에 클릭이 집중되었는지 분석할 수 있습니다.
이 API는 비즈니스 요금제부터 사용할 수 있습니다.
Http Header
GET /api/statistics/v1/clicks-by-hour?linkId={linkId}&domain={domain}&ymd={ymd}
Host: https://vivoldi.com
Authorization: APIKey {Your API Key}
Content-type: -
User-agent: {Your User-agent}
Accept-Language: en
Request
{
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"ymd": "2025-04-20"
}| 필드 | 필드 설명 | 설명 | 필수 | 유형 |
|---|---|---|---|---|
| linkId | 링크 ID | 링크 ID에 특수문자 및 유니코드가 포함되어 있을 경우, URLEncode가 필요합니다. | string | |
| domain | 도메인 | 링크 ID를 직접 설정한 경우 도메인은 “https://vvd.bz”가 아닌 “https://vvd.im” 입니다. | string | |
| ymd | 날짜 | 예: 2025-04-20 | Date |
Response
{
"code": 0,
"message": "",
"result": [
{
"ymd": "2025-04-20",
"hour": "0",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 24,
"pernCnt": 17
},
{
"ymd": "2025-04-20",
"hour": "1",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 121,
"pernCnt": 198
},
{
"ymd": "2025-04-20",
"hour": "2",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 84,
"pernCnt": 68
},
{
"ymd": "2025-04-20",
"hour": "3",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 21,
"pernCnt": 15
},
{
"ymd": "2025-04-20",
"hour": "4",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 1950,
"pernCnt": 1621
},
{
"ymd": "2025-04-20",
"hour": "5",
"linkId": "스타벅스창동점",
"domain": "https://vvd.im",
"acesCnt": 7,
"pernCnt": 7
}
]
}| 필드 | 설명 | 유형 | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| code | 응답 코드 (0:성공) | int | ||||||||||||||||||||||||||||
| message | code가 0이 아닌 경우에 포함되며, 실패 원인을 설명하는 오류 메시지가 담겨 있습니다. | string | ||||||||||||||||||||||||||||
| result |
| array |