時間帯別クリック数

この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
messagecodeが0以外の場合に含まれ、失敗の原因を示すエラーメッセージが格納されます。string
result
フィールドフィールドの説明説明タイプ
ymd日付-Date
hour時間0時〜23時string
linkIdリンクID-string
domainドメイン-string
acesCntクリック数リンクのクリック回数int
pernCntユニークユーザー数リンクをクリックした人数int
array