Analytics overview
The numbers of the team's accounts and of every post on them, made in Rizamo or anywhere else, for a period and the one before it: views, reach, engagements, the engagement rate of the posts published, posts published, followers, the accounts' own reach and accounts engaged, each day, each network, and the top posts. A period of days ends yesterday, the last complete day, as to does when left out. With attribution received (the default), views are each account's own views of each day, as its network counts them (its posts' gains where its days give none, and with fields), and reach and engagements what arrived on the posts in the period, on posts of any age, by the day it arrived; with publish, they are the numbers so far of the posts published in the period, by the day each went out. A number a network does not give is missing, never 0, and notes says why. Post numbers follow the days of the profile's time zone (pass timeZone for another); followers and the accounts' own numbers come by the network's days, matched by date (Meta's run on Pacific time, TikTok's on UTC). TikTok's days come 2 days late and YouTube's 3.
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.
received (the default): what arrived in the period, on posts of any age, on the day it arrived. publish: the posts published in the period, with their numbers so far, on the day each went out.
How series groups the days: day (the default), week (ISO weeks, Monday to Sunday) or month (calendar months). A week's or month's point counts its days as kpis counts a period's, from date to to, and the first and last can hold fewer days. Week or month keeps a long period short.
Response
OK
Example response
{
"topPosts": [
{
"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.