Analytics

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.

get/analytics/overview

Request

  • Base URL
    https://api.rizamo.com/v1
  • Auth
    HTTP bearer

Query parameters

daysinteger

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.

fromstring date

Instead of days: the first day, such as 2026-10-01.

tostring date

With from: the last day, yesterday when left out (today when from is today). Up to 365 days in all.

profileIdstring

Only this profile's (prof_): one brand or client, from List profiles. A profile you do not reach is refused as not found.

timeZonestring

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.

fieldsobject

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.

attribution'received' | 'publish'

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.

interval'day' | 'week' | 'month'

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

fromstring date required

The period's first day, in timeZone.

tostring date required

Its last day: yesterday, the last complete day in timeZone, unless to was given.

timeZonestring required

The time zone the days are in.

attribution'received' | 'publish' required

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.

accountMetricsobject required

The accounts' own numbers, added up over the period's days: views, engagements, follows, unfollows, profile_actions (taps on a profile's buttons) and more, as each network gives them, such as Facebook's profile_visits and video_views, Threads' views (its posts' views, which Meta's reference calls profile views), reposts, quotes and clicks (on links the profile shared), or YouTube's watch_time (in milliseconds, as every watch time) and follows and unfollows (subscribers gained and lost), 2 to 3 days late. Views and reach come split too, each part as the network gives it, so the parts need not add up to the whole: by followers (views_followers and views_non_followers on Instagram, Facebook Pages and YouTube, where they are subscribers or not; reach_followers and reach_non_followers on Instagram), by format (views_feed, views_carousel, views_reel and views_story on Instagram; views_short, views_video and views_live on YouTube) and by ads (views_paid on Instagram and Facebook Pages, views_organic on Facebook Pages). Only metrics in each network's reference are read. reach (people who saw the accounts' content: Instagram, Facebook Pages, and TikTok accounts with advanced access) and accounts_engaged (Instagram, and TikTok with advanced access) are each day's people added up, so someone reached on two days counts twice; missing where no account gives them. A day not collected adds nothing, and notes says so.

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.