Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Analytics

Get the clicks of a page

Where visitors click on one page, from the session replays of the period. x is in thousandths of the width of the page, y in pixels from its top, each rounded to 10. latest is the newest replay that viewed the page: its page is the picture under the clicks.

get/api/v1/analytics/heatmap

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy analytics heatmap
MCP tooltroopy_get_analytics_heatmap
Rate limit60 calls in 60 seconds, for each key

Query parameters

periodenum<string>

now is the last 10 minutes. 7d and 30d end today. 3m, 6m and 12m are whole months that end with this month. week starts on Monday. custom needs from and to

nowtodayyesterday24h7d30d3m6m12mweekmonthyearallcustom

Default "30d"

fromstring

YYYY-MM-DD, in the workspace's time zone

date

tostring

YYYY-MM-DD. The period includes this day

date

page*string

A path, such as /pricing

At least 1 characters · At most 500 characters

screenenum<string>

The clicks of phones (a window under 768 pixels) or of wider screens. Without it, the one with more clicks

mobiledesktop

Response

200 · application/json
data*object
6 properties
page*string
screen*enum<string>

mobiledesktop

replays*integer
latest*string | null
clicks*integer
points*array<object>
3 properties
x*integer
y*integer
n*integer

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.