Analytics

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.

get/analytics/posts

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.

sort'views' | 'reach' | 'engagements' | 'engagementRate' | 'publishedAt'

What to sort by. Posts without that number (a network that does not give it, one it hides, one not read yet) come last.

order'desc' | 'asc'

desc (the default): the highest first. asc: the lowest first.

limitinteger

How many to return, up to 100: 25 when left out.

offsetinteger

How many to skip: the next page starts at offset plus limit.

Response

OK

fromstring date required
tostring date required
timeZonestring required

The time zone the days are in.

totalinteger required

How many posts the period has in all.

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.