---
title: "List commented posts"
method: GET
path: "/inbox/posts"
tags: ["Inbox"]
---

# List commented posts

`GET /inbox/posts`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/inbox/posts`
- Auth: HTTP bearer

The posts on the team's accounts that have comment threads, the most recently commented first, each with its threads counted. A page at a time, 100 unless `limit` says fewer: pass `nextCursor` as `cursor` for the next one, with the same filters.

## Query parameters

- `profileId` string: Only this profile's (`prof_`): one brand or client, from List profiles. A profile you do not reach is refused as not found.
- `limit` integer: How many to return, up to 100: 100 when left out.
- `cursor` string: `nextCursor` from the page before, with the same filters.

## Response `200`

OK

- object
  - `items` InboxPost[], required
    - `post` NetworkPost, required
      - `id` string, required
      - `profileId` string, required
      - `accountId` string, required
      - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
      - `networkId` string, 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.
      - `postId` string, 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.
      - `caption` string, nullable, required
      - `url` string, nullable, required: Where it is on the network.
      - `thumbnailUrl` string, 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.
      - `publishedAt` string, date-time, required
      - `deletedAt` string, date-time, nullable, required: When Rizamo found it gone from the network. A deleted post keeps no caption or picture.
      - `metrics` object, 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.
      - `metricsAt` string, date-time, nullable, required: When those numbers were read.
      - `details` PostDetails, nullable: What the network says about the post that is not a count: rates in percent, where its views came from, who watched and for how long. The latest read only, with no history (`metrics` has the counts and the timeline their days); each part is the last one a read brought, read when `detailsAt` says. Null until a read brings one, and on networks that give none.
        - `skip_rate` number: The share of views skipped in the first 3 seconds, in percent. From Instagram reels.
        - `completion_rate` number: The share of viewers who watched the whole video, in percent. From TikTok videos.
        - `avg_view_percentage` number: How much of the video a view watched on average, in percent. From YouTube posts.
        - `traffic_sources` object[]: Where its views came from, as the network gives it: each source's share of the views in percent (`percent`), or its views (`views`), never one worked out from the other. From TikTok posts and YouTube posts. Largest first.
          - `source` string, required: Where the views came from: `for_you`, `following`, `profile`, `search`, `sound`, `hashtag`, `direct_message`, `other`, or the network's own name in lower case with underscores.
          - `percent` number: Its share of the views, in percent, where the network gives shares.
          - `views` integer: Its views, where the network gives counts. Never worked out from a share, or a share from them.
        - `viewer_types` object[]: New and returning viewers, followers and non-followers: each type's share of the viewers in percent (`percent`), or its views (`views`), as the network gives it. From TikTok posts.
          - `type` 'new' | 'returning' | 'followers' | 'non_followers', required: new and returning viewers make one split, followers and non_followers another: each adds up to the whole on its own.
          - `percent` number: Its share of the views, in percent, where the network gives shares.
          - `views` integer: Its views, where the network gives counts. Never worked out from a share, or a share from them.
        - `retention` object: How many viewers were still watching at each point of the video, in percent of those who started: by the second (`unit` second) or by the share of the video's length from 0 to 1 (`unit` fraction; YouTube's first point is at 0.01, its last at 1, Facebook's first at 0, where the reel starts). From Facebook reels, TikTok videos and YouTube posts.
          - `unit` 'second' | 'fraction', required: second: `at` is seconds into the video. fraction: `at` is the share of its length, from 0 to 1.
          - `points` object[], required: In order of `at`, at most 100: a longer curve (TikTok's, one a second) is picked down to that many of the network's own points, evenly along it, the first and last kept.
            - `at` number, required
            - `percent` number, required: Viewers still watching, in percent of those who started.
        - `viewer_demographics` AudienceBreakdowns: Who watched it, by age, gender, country and city: the groups the network gives, largest first, each as a share in percent (`percent`, its `count` 0) or as views (`count`), as the network gives it, never one worked out from the other. From Facebook reels and TikTok posts. A part the network does not give is empty (TikTok gives no ages per video, Facebook no cities).
          - `age` AudienceShare[], required
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `gender` AudienceShare[], required
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `country` AudienceShare[], required: The top 45, as the network gives them (LinkedIn its top 100).
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `city` AudienceShare[], required: The top 45, as the network gives them; on LinkedIn, its market areas, its top 100.
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `industry` AudienceShare[]: LinkedIn only: a Page's followers by industry, its top 100.
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `jobFunction` AudienceShare[]: LinkedIn only: a Page's followers by job function.
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `seniority` AudienceShare[]: LinkedIn only: a Page's followers by seniority.
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
          - `companySize` AudienceShare[]: LinkedIn only: a Page's followers by the size of the company they work at.
            - `value` string, required: The group: an age range (25-34), a gender (female, male, unknown), a country code (PT), a city (Lisbon, Lisbon District) or, on LinkedIn, a market area (Greater Lisbon), an industry, a job function, a seniority or a company size (2-10 employees), as LinkedIn names them.
            - `count` integer, required: People in the group; views where the network counts views (YouTube's countries, a Facebook reel's viewers). 0 where the network gives only a share (`percent`).
            - `percent` number: The group's share in percent, where the network gives shares and no counts: YouTube's viewers by age and gender, of the views of signed-in viewers.
      - `detailsAt` DetailsAt, 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.
      - `metricsUnavailable` string, 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.
      - `promoted` boolean, 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.
    - `threads` integer, required: Its comment threads: one per first comment, with the replies under it.
    - `open` integer, required: Threads still open.
    - `unread` integer, required: Threads with something nobody has read yet.
    - `lastMessageAt` string, date-time, required: The newest comment or reply on it.
  - `nextCursor` string, nullable, required: Null on the last page.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
