API Method: /api/audience/list
List viewer profiles including timeline activities and conversion events.
Parameters
Parameter | Description |
---|---|
uuid | Search for a specific profile by the automatically assigned uuid. |
user | Search for a specific profile by the user id on the TwentyThree platform |
object | Search for profiled that have viewed a specific object. |
objects | Search for profiled that have viewed one or interacted with one of a set of objects, separated by space. |
identity_objects | Search for profiled that converted through one of a set of objects, separated by space. |
identified | Limit to either identified or non-identified profiles. |
identity_sources | Filter by the source for the profile information, for example 'collector:123' or 'hubspot'. |
search | Free text search for profiles. |
include_timelines_p | Include viewing timelines on the result. |
include_events_p | Include conversion events in the result. |
orderby | Ordering of the returned items. Valid options are: recent, timeline_count, score, first. |
order | Ordering of the returned items. Valid options are: asc, desc. |
offset | Offset / page through the returned profiles. Ideally used together with size |
size | Sets the number of profiles returned. Max value is 500 |
In addition the these search option, a number of filters can be applied to the search. Each filter should be prefixed with <
for less than; >
for greater than or =
for exactly the value. For example, to search for profiles most recently seen within the last 60 minutes, search for use recent=<60
.
Parameter | Description |
---|---|
first | When was the viewer first seen, filterable by minutes. |
recent | When was the viewer most recently seen, filterable by minutes. |
timeline_count | How many videos or live events have been watched. |
timeline_sessions | How many visits with videos watched? |
timeline_engagement | How many minutes of video engagement? |
event_count | How many conversion events? |
score | Engagement score between 0 and 100. |
Permission level
The minimum required permission level is:
<pre><code>read</code></pre>
Example JSON Response
{ "status": "ok", "permission_level": "read", "cached": "0", "profiles": [ { "uuid": "471cde15-53b6-05ea-ad32-f33e7d62d63a", "identifier": 209355, "user": "13697403", "email": "sarah@twentythree.net", "ip": "24.242.88.191", "profile": { "city": "Palo Alto", "logo": "https://logo.clearbit.com/twentythree.net", "name": "Sarah Bay", "site": "http://twentythree.net", "tags": [ "SAAS", "B2B", "Marketing & Advertising", "Corporate & Business" ], "type": "live", "force": "true", "company": "TwentyThree", "country": "United States", "twitter": "Sassy_Bay", "callback": "__audcb_1", "facebook": "twentythree", "lastname": "Bay", "latitude": 37.4135, "username": "sarah", "firstname": "Sarah", "longitude": -122.1312, "formid__sb": "52ebc19c-ccf6-423f-89e2-928154476d44", "hubspotutk": "54614d089677f1d6e361db0fcdf12f01", "marketotrk": "id:288-VFC-510&token:_mch-twentythree.net-1481134994764-58835", "postalCode": "94306", "regionName": "California", "submit__sb": "", "companyInfo": "TwentyThree™ is a video marketing platform that empowers marketing mangers on every step of their marketing funnel.", "companySite": "http://twentythree.net", "companyType": "private", "countryCode": "US", "country_iso": "US", "companyDomain": "unity3d.com", "companySector": "Information Technology", "continentCode": "NA", "companyFacebook": "unity3d", "companyIndustry": "Internet Software & Services", "companyLinkedin": "company/unity-technologies", "companyLocation": "795 Folsom St, San Francisco, CA 94103, USA", "companyTimeZone": "America/Los_Angeles", "identity_source": "sharpspring", "companyEmployees": 975, "companyDescription": "Unity is the ultimate game development platform. Use Unity to build high-quality 3D and 2D games, deploy them across mobile, desktop, VR/AR, consoles or the Web, and connect with loyal and enthusiastic players and customers.", "companySubIndustry": "Internet Software & Services", "identity_collector": "14561518", "companyIndustryGroup": "Software & Services", "companyprofileid__sb": "MzYwNzQ1sDA1BAA", "companyEmployeesRange": "251-1000" }, "identified": true, "identity_sources": "sharpspring,sharpspring:14561518", "timeline_count": 210, "timeline_engagement": 25425, "timeline_sessions": 72, "score": 110, "event_updated": "2016-12-09T16:55:33.200Z", "event_count": 1, "source_first": "embed", "referer_first": "https://www.twentythree.net/", "source_recent": "site", "referer_recent": "https://www.twentythree.net/", "first": "2017-03-14T16:35:47.256Z", "recent": "2017-03-14T16:45:15.035Z", "timelines": [ { "object": "16234013", "ranges": "1111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111", "engagement": 573, "duration": 573, "type": "ondemand", "playhead": 573, "active": true, "source": "site", "referer": "", "first": "2017-03-14T16:35:46", "updated": "2017-03-14T16:35:47.256225" }, { "object": "16195594", "ranges": "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "engagement": 0, "duration": 1166, "type": "ondemand", "playhead": 0, "active": true, "source": "site", "referer": "", "first": "2017-03-11T16:32:28", "updated": "2017-03-11T16:32:29.008182" }, .... ] }, ... ], "site": { ...} "endpoint": "/api/people/list"}
Example XML Response
This endpoint does not support XML responses.