List Convert Signals™ (visitor frustration sessions)

post

https://api.convert.com/api/v2/accounts/{account_id}/projects/{project_id}/signal_sessions

Retrieves a list of Convert Signals™ sessions for a project. Convert Signals™ "is a special anonymous and privacy oriented session recording feature...It shows only really clear frustrations, errors and usability signals of real users". Use this to identify sessions where visitors experienced issues like rage clicks, dead clicks, or scroll stalls. Supports filtering by date, experience, variation, location, country, device, browser, and more.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

account_id

integer

required

ID of the account that owns the retrieved/saved data

project_id

integer

required

ID of the project to be retrieved

Body Params

start_time

number | null

Unix timestamp (seconds since epoch, UTC) marking the beginning of the time range. If null, implies from the beginning of data.

end_time

number | null

Unix timestamp (seconds since epoch, UTC) marking the end of the time range. If null, implies up to the current time.

utc_offset

integer

-43200 to 50400

Defaults to 0

The time offset from Coordinated Universal Time (UTC) in seconds. For example, UTC-5 (EST) would be -18000. UTC+2 would be 7200. Used for interpreting or displaying date/time information according to a specific timezone.

page

integer

≥ 1

The page number for paginated results. For example, if results_per_page is 30, page: 2 will retrieve items 31-60. Defaults to 1 if not specified.

results_per_page

integer | null

0 to 50

Defaults to 30

Specifies the maximum number of items to return in a single page of results. Used for pagination. Default is 30, maximum is 50.

onlyCount

boolean

If set to true in a list request, the response will only contain the total count of matching items (extra.pagination.items_count) and will not include the actual item data. Useful for quickly getting totals without fetching full datasets.

experience

object | null

location_id

integer | null

The ID of the location to filter by

starred

string | null

watched

string | null

country

object | null

browser

object | null

devices

object | null

containsPage

string | null

notContainsPage

string | null

duration

object | null

The duration of the signal session in seconds

pageCount

object | null

entryPage

string | null

exitPage

string | null

referrerURLs

array of strings | null

referrerURLs

trafficChannels

array of strings | null

trafficChannels

adCampaignLabels

array of strings | null

adCampaignLabels

recordingId

string | null

Response

200A list of Convert Signals™ sessions, highlighting visitor interactions that indicate potential frustration or usability issues (e.g., rage clicks, dead clicks). Includes session duration, visited pages, location, and other metadata.