tracking_recordings_list

Tool

tracking_recordings_list

List session recordings of the current product, newest first: who (profile), how they arrived (entry page, utm, ad click), device, length, and whether the session converted.

List session recordings of the current product, newest first: who (profile), how they arrived (entry page, utm, ad click), device, length, and whether the session converted. Filter by period (default the last 30 days), person, visitor, device, campaign, source, entry page, conversion and minimum length; cursor-paged. Device, campaign, source and conversion select the same recordings as tracking_heatmaps_get with the same filters. Returns: { items, nextCursor }. Fails when: cursor is not one this tool issued; the call carries no product.

Behavior

HTTP: GET /tracking/recordings

Arguments

Name	Type	Required	Description
to	string	—	End of the period, ISO 8601: recordings that started at or before it. Default: now.
from	string	—	Start of the period, ISO 8601 (e.g. 2026-10-01T00:00:00Z): recordings that started at or after it. Default: 30 days before `to`, the whole retention window.
limit	integer	—	Recordings per page, 1 to 100 (default 50).
cursor	string	—	Continue a previous page: pass the nextCursor it returned. Omit to start from the newest recording.
device	string	—	Only recordings from this kind of device, as classified on ingest: desktop, tablet or mobile.
converted	boolean	—	true: only sessions with a conversion or a payment; false: only sessions without one. Omit for both.
profileId	string	—	Only this person: every browser they were seen on, merged profiles included.
utmSource	string	—	Only recordings whose entry page carried this utm_source, e.g. google.
anonymousId	string	—	Only this visitor id (one browser).
utmCampaign	string	—	Only recordings whose entry page carried this utm_campaign, e.g. spring.
minDurationMs	integer	—	Only recordings at least this long, in milliseconds, e.g. 30000.
entryUrlContains	string	—	Only recordings whose entry page URL contains this text, case-insensitively, e.g. /pricing.

Response

Field	Type	Always	Description
items	array	•	Newest first.
nextCursor	string	•	Pass back as cursor for the next page. Null on the last page.

Try it

List session recordings of the current product, newest first: who (profile), how they arrived (entry page, utm, ad click), device, length, and whether the session converted.

When to use

Example

Ask your agent something like this:

List session recordings of the current product, newest first: who (profile), how they arrived (entry page, utm, ad click), device, length, and whether the session converted.

The agent will invoke tracking_recordings_list with these arguments:

{}