/api/v1/me/documents/{slug}/analytics/viewersList viewers
Every view in the range, newest first: viewer (a signed-in viewer's name and email, or type: anonymous with a Visitor 3F2A name), started_at, active_s, completion (0–100 or null), location (city, region, country, timezone), system (device, OS and browser with versions, in_app, app: tab, pwa or embed), source, visit_n and acts; plus totals and breakdowns (country, city, device, os, browser, source). Filters: who (all, signed_in, anonymous), completion (any, low, mid, high, done), country, device, os, browser, source; own=1 includes your own views; internal=0 leaves out workspace members; offset and limit page. The owner, and for a workspace item its admins and editors; its viewers get access: counts with totals only.
Guide: Who viewed it
Code samples and Try itPath parameters
#slugstringRequiredThe document's address: the part after
markdrop.in/.
Query parameters
#rangestringThe period to count:
7d,30d,90dorall. One of7d,30d,90d,all. One of7d,30d,90d,all. Default"30d".whostringOne of
all,signed_in,anonymous. One ofall,signed_in,anonymous. Default"all".completionstringOne of
any,low,mid,high,done. One ofany,low,mid,high,done. Default"any".ownintegerFrom 0 to 1. Default
0.internalintegerFrom 0 to 1. Default
1.countrystringUp to 2 characters.
devicestringUp to 20 characters.
osstringUp to 40 characters.
browserstringUp to 40 characters.
sourcestringUp to 120 characters.
offsetintegerFrom 0 to 5,000. Default
0.limitintegerHow many to return. From 1 to 200. Default
50.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.