---
title: "Link statistics"
method: POST
path: "/link/{linkId}"
tags: ["link"]
---

# Link statistics

`POST /link/{linkId}`

Returns detailed statistics for link in given period

## Path parameters

- `linkId` string, required

## Request body

- Model10
  - `include` Model7 — Filter records by provided values
    - `countries` string[] — Return clicks from provided countries
    - `dt` string[]
    - `browsers` string[] — Return clicks from provided browsers
    - `human` boolean — Returns human clicks only if true
    - `socials` string[] — Return clicks from provided social networks
    - `browserVersions` string[] — Return clicks from provided browser versions
    - `statuses` number[] — Return clicks with provided statuses
    - `paths` string[] — Return clicks with provided paths
    - `protos` string[] — Return clicks with provided protocols
    - `methods` string[] — Return clicks with provided methods
    - `refhosts` string[] — Return clicks from provided referrers
    - `utmSources` string[] — Return clicks from provided utm sources
    - `utmMediums` string[] — Return clicks from provided utm mediums
    - `utmCampaigns` string[] — Return clicks from provided utm campaigns
  - `exclude` Model9 — Exclude records with provided values
    - `countries` string[] — Return clicks from provided countries
    - `dt` string[]
    - `browsers` string[] — Return clicks from provided browsers
    - `human` boolean — Returns human clicks only if true
    - `socials` string[] — Return clicks from provided social networks
    - `browserVersions` string[] — Return clicks from provided browser versions
    - `statuses` number[] — Return clicks with provided statuses
    - `paths` string[] — Return clicks with provided paths
    - `protos` string[] — Return clicks with provided protocols
    - `methods` string[] — Return clicks with provided methods
    - `refhosts` string[] — Return clicks from provided referrers
    - `utmSources` string[] — Return clicks from provided utm sources
    - `utmMediums` string[] — Return clicks from provided utm mediums
    - `utmCampaigns` string[] — Return clicks from provided utm campaigns
  - `period` 'custom' | 'today' | 'yesterday' | 'total' | 'week' | 'month' | 'lastmonth' | 'last7' | 'last30' — One of predefined time intervals. Select custom to provide custom dates
  - `tz` string — Timezone name
  - `startDate` string, date — Returns statistics for clicks after given date. Required if period is custom
  - `endDate` string, date — Returns statistics for clicks before given date. Required if period is custom
  - `skipTops` boolean — Skip top records
  - `clicksChartInterval` 'hour' | 'day' | 'week' | 'month' — One of predefined time intervals

## Response `200`

link statistics

---

[API](https://skmtc.net/short/apis/short-io-api.md) · [All operations](https://skmtc.net/short/apis/short-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/short/short-io-api/versions/288b112e7951/schema)