Monthly Click Analytics API

Retrieve monthly click counts (YYYY-MM) for a specified date range.

Analyze long-term traffic trends and growth patterns to better understand campaign performance and user behavior.

This API is available on the Personal plan and above.

GET

/api/statistics/v1/clicks-by-month?startYm={startYm}&endYm={endYm} 


GET /api/statistics/v1/clicks-by-month
     ?startYm=2026-01
     &endYm=2026-04

Request Parameters

startYm string required
Start year and month for the query. Use the YYYY-MM format. Example: 2026-01
endYm string required
End year and month for the query. Use the YYYY-MM format. Example: 2026-04
The allowed start range depends on your plan.
Personal: up to the last 90 days
Premium: up to the last 180 days
Business: up to the last 365 days
linkId string
Link ID. If it contains special characters or Unicode, URL encoding must be applied.
Personal: linkId and domain are required. Only individual link data can be queried.
Premium and above: optional.
domain string
Link domain. Custom domains are supported.
grpIdx integer
Link group ID. Group IDX can be retrieved via the Group List API or from the dashboard.
If specified, the total clicks of all links in the group will be returned.
Available on Premium plans and above. 
{
    "code": 0,
    "message": "",
    "result": [
        {
            "ym": "2026-01",
            "acesCnt": 384,
            "pernCnt": 295
        },
        {
            "ymd": "2026-02",
            "acesCnt": 1785,
            "pernCnt": 1720
        },
        {
            "ymd": "2026-03",
            "acesCnt": 19542,
            "pernCnt": 19083
        },
        {
            "ymd": "2026-04",
            "acesCnt": 3596,
            "pernCnt": 3274
        }
    ]
}

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
ym string
Year and month, returned in YYYY-MM format. Example: 2026-01
acesCnt integer
Total number of clicks for the specified month.
pernCnt integer
Number of unique users who clicked the link during the specified month.

When to Use This API

Use this API to analyze link traffic trends on a monthly basis.

It is especially useful for summarizing quarterly or semi-annual campaign performance, analyzing seasonal traffic patterns, and preparing annual marketing reports.

Compared to the Clicks by Date API, it is better suited for long-term trend analysis.

Difference from the Clicks by Date API

The Clicks by Date API aggregates data on a daily basis and is ideal for short-term analysis, while the Monthly Click API aggregates data monthly and is better suited for long-term insights.
Additionally, depending on your plan, it supports queries of up to 365 days, making it suitable for annual performance analysis.
※ Business Plus and Enterprise plans may support up to 2 years depending on contract terms

Plan-Based Query Limits

This API is available on the Personal plan and above. The available query range varies by plan.

The Personal plan allows up to the last 90 days, the Premium plan up to 180 days, and the Business plan up to 365 days.
Group-level queries using grpIdx are available only on the Premium plan and above.

Key Metrics & Analysis

This API provides monthly aggregated data.

Monthly Clicks (accsCnt)

  • Total clicks for the month
  • Track traffic growth or decline trends

Users (pernCnt)

  • Number of unique users for the month
  • Measure actual traffic volume

These metrics help you analyze growth rates, seasonal patterns, and long-term performance.

Use Cases

  • Quarterly performance reports: Define the period with startYm and endYm to analyze monthly click trends
  • Seasonality analysis: Retrieve a full year of data to identify peak traffic months
  • Long-term campaign trends: Use grpIdx to analyze monthly click patterns across a campaign group
  • Annual marketing reports: On the Business plan, collect up to 365 days of data for annual reporting

Things to consider

  • startYm and endYm are required parameters and must follow the YYYY-MM format.
  • The maximum query range depends on your plan. Exceeding the limit will return an error.
  • If linkId contains special characters or Unicode, URL encoding is required.
  • This API is available on the Personal plan and above. Verify your plan before use.