rizamodocs
Network posts

Get a post's numbers day by day

GET
/network-posts/{id}/timeline

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.

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

Query Parameters

timeZone?string

The time zone the days are in: the profile's when left out.

Lengthlength <= 64

Response Body

OK

application/json
  1. response
networkPostId*string
timeZone*string

The time zone the days are in.

points*array<>

Oldest first. A day with neither a point nor a gap had no change. A point over several days is a change Rizamo cannot place on one day, never split: gaps says why.

gaps*array<>

Days whose numbers Rizamo could not read one by one, or not at all, and why.

Example Request
curl -X GET 'https://api.rizamo.com/v1/network-posts/npost_01m4fkyer0em9939e5rz4f89v7/timeline'
Example Response
{  "networkPostId": "npost_01m4fkyer0em9939e5rz4f89v7",  "timeZone": "Europe/Lisbon",  "points": [    {      "from": "2026-11-06",      "date": "2026-11-06",      "change": {        "views": 1720,        "reach": 1310,        "likes": 101,        "comments": 9      },      "total": {        "views": 1720,        "reach": 1310,        "likes": 101,        "comments": 9      },      "masked": [],      "source": "poll",      "checkedAt": "2026-11-06T23:00:00.000Z"    },    {      "from": "2026-11-07",      "date": "2026-11-07",      "change": {        "views": 420,        "reach": 320,        "likes": 27,        "comments": 2      },      "total": {        "views": 2140,        "reach": 1630,        "likes": 128,        "comments": 11      },      "masked": [],      "source": "poll",      "checkedAt": "2026-11-07T09:00:00.000Z"    }  ],  "gaps": []}