rizamodocs
Network posts

Get a post on a network

GET
/network-posts/{id}

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.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Path Parameters

id*string

The post on the network's id (npost_).

Lengthlength <= 100

Response Body

OK

application/json
  1. response
id*string
profileId*string
accountId*string
network*Network
Value in"instagram""facebook""threads""linkedin""tiktok""youtube""x""pinterest""google"
networkId*string

Its id on the network.

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"
postId*|

The Rizamo post it went out as. Null when it was made elsewhere.

format*PostFormat

What a target publishes: feed, carousel, reel, story, video, short, photo, document or pin.

Value in"feed""carousel""reel""story""video""short""photo""document""pin"
caption*string|null
url*|

Where it is on the network.

thumbnailUrl*|

A small copy of its picture that Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the post again for a fresh one. The network's own link until the copy is made.

publishedAt*string
Formatdate-time
deletedAt*|

When Rizamo found it gone from the network. A deleted post keeps no caption or picture.

metrics*|

Its latest lifetime totals, as the network reports them, by the names every network shares (impressions, reach, engagements, likes, comments, shares, saves, clicks, views) and a few only some have (Instagram stories: replies, and navigation with its parts taps_forward, taps_back, exits and swipes_forward; Instagram and Facebook reels, TikTok and YouTube: watch_time and avg_watch_time in milliseconds; Instagram feed posts and stories, Facebook reels, TikTok and YouTube: follows, which on YouTube are the subscribers a video brought from its watch page; Instagram feed posts and stories and TikTok: profile_visits; Instagram and Threads: reposts; Threads: quotes, and comments for its replies; YouTube: engaged_views, plays past the first frame or a tap to play, as YouTube counted views before its views began counting every start: Shorts from 31 March 2025, every video from 24 August 2026). A Facebook reel's reach is its Page post's viewers, where Meta gives them, and its likes every reaction. Facebook stories have none: Meta gives no numbers for them. A YouTube video has no engagements: YouTube's policies forbid numbers worked out from its own, and its watch times, shares, follows and engaged views come 2 to 3 days late. A Threads thread Rizamo published counts its posts' numbers summed, and its replies once: the first post's (every reply under it), less its own parts. A null value is one the network hides because it is small (Meta: under 5). Null until Rizamo first reads them: 1 hour after publishing, then at 6 hours, daily to day 90 and every 30 days after (YouTube every 28) (TikTok's until a year, when TikTok stops updating them, and 24 to 48 hours late, so its first read is at 24 hours; YouTube's views, likes and comments from the first hour, its other numbers 2 to 3 days late); stories every 2 hours while live.

metricsAt*|

When those numbers were read.

details?|null
detailsAt?|null
metricsUnavailable*|

Why the network keeps no numbers for it, such as an Instagram post from before the account became a professional account.

promoted*|

Whether the network says the post is promoted in an ad: TikTok's Spark Ads (true while it is used in one), whose views then include paid ones, as every TikTok view count does. A post shown only in ads is listed too, with true. Null on networks that do not say.

metricsFinal*|

Stories: their numbers are final, and what made them so. read: Rizamo read them 23 hours after the story went up, the last read while it is live (the final numbers for accounts connected through Instagram Login). webhook: Instagram sent them an hour after the story ended (accounts connected through a Facebook Page). Null while they can still change.

Example Request
curl -X GET 'https://api.rizamo.com/v1/network-posts/npost_01m4fkyer0em9939e5rz4f89v7'
Example Response
{  "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}