List how each post did
Every post published in the period on the team's accounts, made in Rizamo or anywhere else, deleted ones included, with its numbers so far: its lifetime totals as Rizamo last read them, every one its network gives in metrics, and its details (rates, traffic sources, viewer types, retention, viewers) where its network gives them. Sorted by views unless asked otherwise, a page at a time. Days are the profile's, and a period of days ends yesterday, as in Analytics overview.
Request
- Base URLhttps://api.rizamo.com/v1
- AuthHTTP bearer
Query parameters
The last this many complete days, up to yesterday in timeZone: today is not over, so it is left out. 30 when neither this nor from is given.
Instead of days: the first day, such as 2026-10-01.
With from: the last day, yesterday when left out (today when from is today). Up to 365 days in all.
Only this profile's (prof_): one brand or client, from List profiles. A profile you do not reach is refused as not found.
The time zone the days are in. Left out: the profile's with profileId; else the one every profile in reach shares, or UTC when they differ.
Only posts made in Rizamo whose custom fields have these values, for example fields[campaign]=Winter menu: posts made in the networks' own apps have no fields, so they are left out, and so are followers.
What to sort by. Posts without that number (a network that does not give it, one it hides, one not read yet) come last.
desc (the default): the highest first. asc: the lowest first.
How many to return, up to 100: 25 when left out.
How many to skip: the next page starts at offset plus limit.
Response
OK
Example response
{
"items": [
{
"metrics": {
"reach": 812,
"views": 1460,
"likes": 64,
"comments": 5,
"shares": 3,
"saves": 11,
"engagements": 83,
"follows": 4,
"profile_visits": 37
},
"details": {
"completion_rate": 18.4,
"traffic_sources": [
{
"source": "for_you",
"percent": 81.2
},
{
"source": "following",
"percent": 9.5
},
{
"source": "profile",
"percent": 6.1
},
{
"source": "search",
"percent": 3.2
}
],
"viewer_types": [
{
"type": "new",
"percent": 88
},
{
"type": "returning",
"percent": 12
},
{
"type": "followers",
"percent": 7
},
{
"type": "non_followers",
"percent": 93
}
],
"retention": {
"unit": "second",
"points": [
{
"at": 0,
"percent": 100
},
{
"at": 1,
"percent": 71.5
},
{
"at": 2,
"percent": 58.2
}
]
}
},
"detailsAt": {
"completion_rate": "2026-11-07T00:04:12.000Z",
"traffic_sources": "2026-11-07T00:04:12.000Z"
}
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.