時間帯別クリック数 (v3)

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

照会条件

  • linkId + domain を両方指定 → 該当リンクの時間帯別クリック数を取得。
  • grpIdx を指定 → 指定グループに属するリンクの合計クリック数を取得。
  • 条件なし → アカウント全体の時間帯別クリック数を取得。

このAPIは特定の日付におけるクリックトラフィックの分布を分析するために使用されます。
イベント効果測定、マーケティングの集中時間帯の把握、ユーザー行動パターンの分析に役立ちます。

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

GET

/api/statistics/v3/clicks-by-hour?startYmd={startYmd}&endYmd={endYmd} 

{
    "startYmd": "2025-04-01",
    "endYmd": "2025-04-30"
}

Request Parameters

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

Response Parameters

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