Get device/browser/OS breakdown

GET

/api/v1/links/{code}/analytics/devices

curl --request GET \
  --url 'https://example.com/api/v1/links/example/analytics/devices?from=2026-02-01T00%3A00%3A00Z&to=2026-02-27T23%3A59%3A59Z&granularity=hour&limit=20&limit_countries=20&limit_cities=20&compare=prev_period' \
  --header 'Authorization: Bearer <token>'

Authorizations

• bearer

Parameters

Path Parameters

code

required

string

Short code or custom alias

Query Parameters

from

string

Example

2026-02-01T00:00:00Z

Start date (ISO 8601). Default: 30 days ago

to

string

Example

2026-02-27T23:59:59Z

End date (ISO 8601). Default: now

granularity

string

default: day

Allowed values: hour day week month

limit

number

default: 20 >= 1 <= 100

limit_countries

number

default: 20 <= 250

Limit for countries (geo endpoint)

limit_cities

number

default: 20 <= 100

Limit for cities (geo endpoint)

countries

Array<string>

Filter by ISO 3166-1 alpha-2 country codes (comma-separated)

compare

string

Allowed values: prev_period prev_year

Compare with a previous period

Responses

200

Media typeapplication/json

object

shortCode

required

string

from

required

string

to

required

string

totalClicks

required

number

deviceTypes

required

Array<object>

object

type

required

string

clicks

required

number

percentage

required

number

browsers

required

Array<object>

object

browser

required

string

clicks

required

number

percentage

required

number

operatingSystems

required

Array<object>

object

os

required

string

clicks

required

number

percentage

required

number

Example ^generated

{
  "shortCode": "example",
  "from": "example",
  "to": "example",
  "totalClicks": 1,
  "deviceTypes": [
    {
      "type": "example",
      "clicks": 1,
      "percentage": 1
    }
  ],
  "browsers": [
    {
      "browser": "example",
      "clicks": 1,
      "percentage": 1
    }
  ],
  "operatingSystems": [
    {
      "os": "example",
      "clicks": 1,
      "percentage": 1
    }
  ]
}

403

Forbidden — not the owner

404

Link not found