時間帯別クリック数取得API (v2)

指定した期間内の時間帯別（00:00〜23:59）クリック数を取得するAPIです。

特定リンク・グループ単位、またはアカウント全体の時間帯別トラフィック分布を分析できます。
キャンペーン効果の測定や最適な配信時間の特定、ユーザー行動の把握に活用できます。

このAPIはパーソナルプラン以上で利用可能です。

v2（レガシー）ドキュメントです。

新規連携には、最新バージョンである v3 のご利用を推奨します。
v2 は既存連携を維持するためのバージョンであり、新機能や改善は提供されません。

GET

/api/statistics/v2/clicks-by-hour?ymd={ymd} 

{
    "ymd": "2025-04-20"
}

Request Parameters

ymd date required
照会基準日。例: 2025-04-20
linkId string
リンクID。特殊文字やUnicodeが含まれる場合、URLエンコードが必要です。
パーソナルプラン: linkIdとdomainが必須で、個別リンクのクリック数のみ取得可能。
プレミアムプラン以上: 任意入力可能。
domain string
リンクドメイン。
grpIdx integer
リンクグループ。 グループIDXはグループ一覧APIを呼び出すか、ダッシュボードで確認できます。
指定された場合、そのグループに属するすべてのリンクのクリック数合計が返されます。プレミアムプラン以上で利用可能。 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ymd": "2025-04-20",
            "hour": 0,
            "acesCnt": 24,
            "pernCnt": 17
        },
        {
            "ymd": "2025-04-20",
            "hour": 1,
            "acesCnt": 121,
            "pernCnt": 198
        },
        {
            "ymd": "2025-04-20",
            "hour": 2,
            "acesCnt": 84,
            "pernCnt": 68
        },
        {
            "ymd": "2025-04-20",
            "hour": 3,
            "acesCnt": 21,
            "pernCnt": 15
        },
        {
            "ymd": "2025-04-20",
            "hour": 4,
            "acesCnt": 1950,
            "pernCnt": 1621
        },
        {
            "ymd": "2025-04-20",
            "hour": 5,
            "acesCnt": 7,
            "pernCnt": 7
        }
    ]
}

Response Parameters

codeinteger
レスポンスコード: 0 = 成功、それ以外 = エラー
messagestring
レスポンスメッセージ。レスポンスコードが0以外の場合、エラー内容のメッセージが返されます。
resultarray
ymddate
日付。
hourinteger
時間 (0〜23)。
acesCntinteger
指定した時間帯の総クリック数。
pernCntinteger
その時間帯にリンクをクリックしたユニークユーザー数。