---
title: "Top column values for specified link path"
method: POST
path: "/link/{linkId}/top"
tags: ["link"]
---

# Top column values for specified link path

`POST /link/{linkId}/top`

## Request

- Base URL: `https://statistics.short.io/statistics`
- URL: `https://statistics.short.io/statistics/link/{linkId}/top`
- Auth: API key in header `Authorization`

Returns values and counts for specified link path

## Path parameters

- `linkId` string, required

## Request body

- Model43
  - `include` Model40: 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` Model42: 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
  - `column` 'path' | 'path_404' | 'method' | 'st' | 'proto' | 'human' | 'browser' | 'browser_version' | 'country' | 'city' | 'social' | 'refhost' | 'os' | 'utm_source' | 'utm_medium' | 'utm_campaign' | 'goal_completed' | 'ab_path', required: column for the aggregation
  - `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
  - `limit` number
  - `tz` string: Timezone name
  - `prefix` string

## Response `200`

top link path response

- Model29[]
  - `score` number, required: Number of clicks
  - `column` string, required: Value of the column
  - `displayName` string, required: Display name of the column

---

[API](https://skmtc.dev/short/apis/statistics-api.md) - [All operations](https://skmtc.dev/short/apis/statistics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/short/apis/statistics-api/revisions/b87df490eedc?raw)