時間帯別クリック数
このAPIは、指定した短縮リンクの1日分の時間帯別(0時~23時)クリック数を取得します。
特定の日付にどの時間帯にクリックが集中したかを分析するのに役立ちます。
この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に特殊文字やUnicodeが含まれる場合は、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 |