GET
/
analytics
/
top_urls
curl --request GET \
  --url https://api.dub.co/analytics/top_urls \
  --header 'Authorization: Bearer <token>'
[
  {
    "url": "<string>",
    "clicks": 123
  }
]

Analytics endpoints require a Pro plan subscription or higher.

Authorizations

Authorization
string
headerrequired

Default authentication mechanism

Query Parameters

workspaceId
string
required

The ID of the workspace.

projectSlug
string
deprecated

The slug of the project. This field is deprecated – use workspaceId instead.

domain
string

The domain of the short link.

key
string

The short link slug.

linkId
string

The unique ID of the short link on Dub.

externalId
string

This is the ID of the link in the your database. Must be prefixed with 'ext_' when passed as a query parameter.

interval
enum<string>

The interval to retrieve analytics for.

Available options:
1h,
24h,
7d,
30d,
90d,
all
country
enum<string>

The country to retrieve analytics for.

Available options:
AF,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CA,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IL,
IT,
JM,
JP,
JO,
KZ,
KE,
KI,
KP,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MK,
MP,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
SH,
KN,
LC,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
SC,
SL,
SG,
SK,
SI,
SB,
SO,
ZA,
GS,
ES,
LK,
SD,
SR,
SJ,
SZ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW,
AX,
BQ,
CW,
GG,
IM,
JE,
ME,
BL,
MF,
RS,
SX,
SS,
XK
city
string

The city to retrieve analytics for.

device
string

The device to retrieve analytics for.

browser
string

The browser to retrieve analytics for.

os
string

The OS to retrieve analytics for.

referer
string

The referer to retrieve analytics for.

url
string

The URL to retrieve analytics for.

tagId
string

The tag ID to retrieve analytics for.

qr
boolean

Filter for QR code scans. If true, filter for QR codes only. If false, filter for links only. If undefined, return both.

root
boolean

Filter for root domains. If true, filter for domains only. If false, filter for links only. If undefined, return both.

Response

200 - application/json
url
string
required

The destination URL

clicks
number
required

The number of clicks from this URL

Was this page helpful?

Retrieve top linksCreate a workspace