Network posts

List posts on the networks

Every post on the team's connected accounts, whoever made it: published through Rizamo (origin rizamo, with its postId) or in the network's own apps (external). Newest first, a page at a time: pass nextCursor as cursor for the next one. Rizamo finds new posts within the hour; when an account is connected it reads back 12 months. A LinkedIn profile's posts made outside Rizamo are not listed, as LinkedIn lists them to select developers only. Each post has its latest metrics, read 1 hour and 6 hours after it went out (TikTok's and YouTube's from 24 hours, as their numbers come a day or more late), then daily to day 90 and every 30 days after (YouTube every 28).

get/network-posts

Request

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

Query parameters

accountIdstring

Only this account's posts (acc_).

profileIdstring

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

origin'rizamo' | 'external'

rizamo: published through Rizamo, and postId is that post. external: made in the network's own apps or another tool.

format'feed' | 'carousel' | 'reel' | 'story' | 'video' | 'short' | 'photo' | 'document' | 'pin'

Only posts of this format.

fromstring date-time

Published at or after.

tostring date-time

Published at or before.

deleted'exclude' | 'include' | 'only'

Posts gone from the network are left out unless asked.

cursorstring

nextCursor from the page before.

limitinteger

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

Response

OK

nextCursorstring nullable required

Null on the last page.

Example response

{
  "items": [
    {
      "metrics": {
        "reach": 812,
        "views": 1460,
        "likes": 64,
        "comments": 5,
        "shares": 3,
        "saves": 11,
        "engagements": 83
      },
      "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.