rizamodocs
Network posts

List posts on the networks

GET
/network-posts

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. 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).

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the web app, under Developers. It starts with rz_live_.

Query Parameters

accountId?string

Only this account's posts (acc_).

Lengthlength <= 100
profileId?string

Only this profile's (prof_): one brand or client, from List profiles.

Lengthlength <= 100
origin?string

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

Value in"rizamo""external"
format?string

Only posts of this format.

Value in"feed""carousel""reel""story""video""short""photo""document""pin"
from?string

Published at or after.

Formatdate-time
to?string

Published at or before.

Formatdate-time
deleted?string

Posts gone from the network are left out unless asked.

Default"exclude"
Value in"exclude""include""only"
cursor?string

nextCursor from the page before.

Lengthlength <= 1000
limit?integer

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

Range1 <= value <= 100
Default50

Response Body

OK

application/json
  1. response
items*array<>
nextCursor*|

Null on the last page.

Example Request
curl -X GET 'https://api.rizamo.com/v1/network-posts?accountId=acc_01m423bp00fz39kp5pc7m42tsw&limit=20'
Example Response
{  "items": [    {      "id": "npost_01m4fkyer0em9939e5rz4f89v7",      "profileId": "prof_01m40k9k80fxd8cvng8derm7g9",      "accountId": "acc_01m423bp00fz39kp5pc7m42tsw",      "network": "instagram",      "networkId": "18063321457890123",      "origin": "rizamo",      "postId": "post_01m47bjzm0edmtk7w6gp7br39v",      "format": "feed",      "caption": "Winter menu is here: spiced orange latte and our first pastel de nata of the season. Open from 8 tomorrow.",      "url": "https://www.instagram.com/p/DQx8kLmCa1T/",      "thumbnailUrl": "https://media.rizamo.com/thumbnails/npost_01m4fkyer0em9939e5rz4f89v7.jpg?exp=1762437600&sig=b3Jp1Wq0kz8fLx2mQe7Rt5uYc9NvH4aD6sGj3hKl0Po",      "publishedAt": "2026-11-06T09:00:04.000Z",      "deletedAt": null,      "metrics": {        "views": 2140,        "reach": 1630,        "likes": 128,        "comments": 11,        "shares": 6,        "saves": 10,        "engagements": 155,        "follows": 4,        "profile_visits": 37      },      "metricsAt": "2026-11-07T09:00:00.000Z",      "details": null,      "detailsAt": null,      "metricsUnavailable": null,      "metricsFinal": null,      "promoted": null    }  ],  "nextCursor": "MjAyNi0xMS0wNlQwOTowMDowNC4wMDBafG5wb3N0XzAxbTRma3llcjBlbTk5MzllNXJ6NGY4OXY3"}

Stop sharing a post's preview POST

Every preview link of the post stops working at once. `sharedUntil` becomes null.

Get a post on a network GET

One post on a network, made through Rizamo or anywhere else: its caption, link and format, the Rizamo post it went out as, whether it is still on the network, its latest numbers with when they were read, and its `details` (rates, traffic sources, viewer types, retention, viewers) where its network gives them.