Get a post on a network
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.
apiKeyAuthorizationBearer <token>An API key from the web app, under Developers. It starts with rz_live_.
id*stringThe post on the network's id (npost_).
length <= 100OK
application/json- response
id*stringprofileId*stringaccountId*stringnetwork*Network"instagram""facebook""threads""linkedin""tiktok""youtube""x""pinterest""google"networkId*stringIts id on the network.
origin*stringrizamo: published through Rizamo, and postId is that post. external: made in the network's own apps or another tool.
"rizamo""external"postId*|The Rizamo post it went out as. Null when it was made elsewhere.
format*PostFormatWhat a target publishes: feed, carousel, reel, story, video, short, photo, document or pin.
"feed""carousel""reel""story""video""short""photo""document""pin"caption*string|nullurl*|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*stringdate-timedeletedAt*|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?|nulldetailsAt?|nullmetricsUnavailable*|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.
curl -X GET 'https://api.rizamo.com/v1/network-posts/npost_01m4fkyer0em9939e5rz4f89v7'{ "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}List posts on the networks GET
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).
Get a post's numbers day by day GET
What each day added to the post's numbers, and the totals after it, from Rizamo's reads: 1 hour and 6 hours after it went out (TikTok's and YouTube's from 24 hours), then daily to day 90 and every 30 days after (YouTube every 28). A day with no point had no change. A change between two reads several days apart is one point over those days, never split, and `gaps` says why, as it does for days Rizamo could not read. Days are the profile's.