rizamodocs
Inbox

List commented posts

GET
/inbox/posts

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.

Authorization

apiKey
headerAuthorizationBearer <token>

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

Query Parameters

profileId?string

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

Lengthlength <= 100
limit?integer

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

Range1 <= value <= 100
Default100
cursor?string

nextCursor from the page before, with the same filters.

Lengthlength <= 1000

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/inbox/posts?profileId=prof_01m40k9k80fxd8cvng8derm7g9'
Example Response
{  "items": [    {      "post": {        "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      },      "threads": 11,      "open": 3,      "unread": 2,      "lastMessageAt": "2026-11-06T10:14:00.000Z"    }  ],  "nextCursor": null}

List inbox threads GET

One thread per first comment, with the replies under it, and one per person for messages. Those with the newest messages first, 200 at a time unless `limit` says fewer: pass `nextCursor` as `cursor` for the next page, with the same filters.

Get a thread with its messages GET

Its messages oldest first: every one without `limit`; with it, the newest `limit`, and `nextCursor`, passed as `before`, gives the ones before them.