日別クリック数

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

照会条件

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

このAPIは、指定期間におけるクリックトラフィックの変化を分析するのに役立ちます。
マーケティング効果の測定、キャンペーンのトレンド把握、ユーザー流入動向の分析などに活用できます。

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

GET

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

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

Request Parameters

startYmddaterequired
照会開始日（例: 2025-04-01）
endYmddaterequired
照会終了日（例: 2025-04-30）。開始日と終了日の最大範囲は1か月です。
linkIdstring
リンクID。特殊文字やUnicodeが含まれる場合、URLエンコードが必要です。
パーソナルプラン: linkIdとdomainが必須で、個別リンクのクリック数のみ取得可能。
プレミアムプラン以上: 任意入力可能。
domainstring
リンクドメイン。
grpIdxinteger
リンクグループ。 グループ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
その日にリンクをクリックしたユニークユーザー数。