日別クリック数取得API (v2)

指定した期間内の日別（YYYY-MM-DD）クリック数を取得するAPIです。

特定リンク・グループ単位、またはアカウント全体のクリックトラフィックの推移を日単位で分析できます。
キャンペーン効果の測定やトレンド把握、ユーザー流入の変化分析に活用できます。

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

GET

/api/statistics/v2/clicks-by-date?startYmd={startYmd}&endYmd={endYmd} 


GET /api/statistics/v2/clicks-by-date
     ?startYmd=2025-04-01
     &endYmd=2025-04-30

Request Parameters

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

Response Parameters

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

このAPIを利用する場面

リンククリックの推移を日単位で把握したい場合に利用します。

キャンペーン前後のトラフィック比較や、曜日ごとの傾向分析、イベント前後の反応評価に適しています。

単なる集計ではなく、時間軸に基づくトレンド分析に活用されます。

時間帯別クリック数APIとの違い

時間帯別クリック数APIは1日を0〜23時で区切り時間単位で集計し、本APIは日単位で集計します。

1日の中での反応を分析したい場合は時間帯別API、数日〜数週間の傾向を把握したい場合は日別APIを利用してください。

取得対象の指定方法

取得範囲は次の3つの方法で指定できます。

linkIdとdomainを指定すると、対象リンクの日別クリック数を取得します。
grpIdxを指定すると、グループ内すべてのリンクのクリック数を合算して取得します。
いずれも指定しない場合は、アカウント全体の日別クリック数が返されます。

主な機能と分析指標

このAPIは日単位の集計データを提供します。

日別クリック数（accsCnt）

  • 各日の総クリック数
  • トラフィックの増減を把握

ユーザー数（pernCnt）

  • 各日のユニークユーザー数
  • クリックに対するユーザー動向を分析

これらの指標により、成長推移やキャンペーン効果、重複クリックの傾向を把握できます。

活用例

  • キャンペーン効果測定: startYmdとendYmdで期間を指定し、日別クリック推移を把握
  • 曜日別パターン分析: 週間単位で取得し、クリックが集中する曜日を特定
  • イベント効果比較: 前後期間のトラフィックを比較
  • 異常トラフィック検知: 特定日の急激なクリック増加を確認

利用時の注意点

  • 取得可能な最大期間はプランによって異なり、上限を超えるとエラーが返されます。
  • 日単位データには時間単位の詳細は含まれません。
  • linkIdに特殊文字やUnicodeが含まれる場合は、URLエンコードを適用してください。
  • パーソナルプランでは、linkIdとdomainを必ず同時に指定する必要があります。