Daily Click Analytics API (v2)

Retrieve daily click counts (YYYY-MM-DD) for a selected date range.

Analyze day-by-day traffic trends for a specific link, group, or your entire account.
Use it to measure campaign performance, track trends, and understand user acquisition patterns.

This API is available on the Personal plan and above.

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
Query start date (e.g., 2025-04-01)
endYmd date required
End date of the query (e.g. 2025-04-30). The maximum range between the start and end dates is 1 month.
Personal plan: up to 7 days
Premium plan: up to 14 days
linkId string
Link ID. If it contains special characters or Unicode, URL encoding is required.
Personal plan: linkId and domain are required, only individual link clicks can be retrieved.
Premium plans or higher: optional input.
domain string
Link domain.
grpIdx integer
Link group. The group IDX can be obtained by calling the Group List API or checking in the dashboard.
If specified, the total click count of all links in that group will be returned. Available only on Premium plans or higher. 
{
    "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
Response code: 0 = Success, any other value = Error
messagestring
Response message. If the response code is not 0, an error-related message is returned.
resultarray
ymddate
Date.
acesCntinteger
Total clicks on the specified date.
pernCntinteger
Number of unique users who clicked links on that date.

When to Use This API

Use this API to understand how link clicks change over time on a daily basis.

It helps compare traffic before and after campaigns, analyze day-of-week patterns, and evaluate performance around key events.

It goes beyond simple counts and enables trend analysis over time.

Difference from the Hourly Click API

The Hourly Click API aggregates clicks by hour (0–23), while this API aggregates by date.

Use the hourly API to analyze short-term engagement within a day, and the daily API to understand trends across multiple days or weeks.

How to Define the Query Scope

You can define the query scope in three ways.

Provide linkId and domain to retrieve daily clicks for a specific link.
Provide grpIdx to retrieve aggregated clicks across all links in a group.
If neither is provided, the API returns daily click data for the entire account.

Key features and analysis metrics

This API provides daily aggregated data.

Daily clicks (accsCnt)

  • Total clicks per date
  • Identify increases or drops in traffic

Unique users (pernCnt)

  • Number of unique users per date
  • Analyze user flow relative to clicks

These metrics help you understand growth trends, campaign performance, and repeated click behavior.

Use cases

  • Measure campaign performance: Define the period with startYmd and endYmd to track daily click trends
  • Analyze day-of-week patterns: Query weekly data to identify peak days
  • Compare event impact: Compare traffic before and after events
  • Detect abnormal traffic: Investigate sudden spikes in clicks on specific dates

Things to consider

  • The maximum queryable date range depends on your plan. Requests beyond this limit will return an error.
  • Daily data does not include hourly breakdowns.
  • If linkId contains special characters or Unicode, apply URL encoding.
  • On the Personal plan, linkId and domain must be provided together.