Network posts

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.

get/network-posts/{id}

Request

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

Path parameters

idstring required

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

Response

OK

idstring required
profileIdstring required
accountIdstring required
network'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google' required
networkIdstring required

Its id on the network.

origin'rizamo' | 'external' required

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

postIdstring nullable required

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

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

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

captionstring nullable required
urlstring nullable required

Where it is on the network.

thumbnailUrlstring nullable required

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.

publishedAtstring date-time required
deletedAtstring date-time nullable required

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

metricsobject nullable required

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 and Facebook stories: replies; Instagram stories: 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. A Facebook story has views, reach, engagements (Meta's own total), replies and shares, read while it is live and only with read_insights; one that ended before Rizamo read it has none, as metricsUnavailable says. 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, the last time 23 hours after they went up.

metricsAtstring date-time nullable required

When those numbers were read.

detailsAtDetailsAt nullable

When each of details was read, by its key. A read that does not bring a detail (TikTok stops giving them after a week with no views) leaves its last value and time, so a detail read before metricsAt is from an earlier read than the numbers. Null when details is.

metricsUnavailablestring nullable required

Why it has no numbers and will get none: an Instagram post from before the account became a professional account, a story that ended before Rizamo read it (Facebook's, whose numbers are read only while it is live), or a post deleted with no numbers kept (YouTube keeps none once a video is gone; elsewhere it went before Rizamo's first read). Null while it has numbers, or its first read is still to come.

promotedboolean nullable required

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'read' | 'webhook' nullable required

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 response

{
  "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.