content_metrics_post_series

Tool

content_metrics_post_series

Metric snapshots of one published post on one channel, over time — how reach and engagement grew, not a single current number.

Metric snapshots of one published post on one channel, over time — how reach and engagement grew, not a single current number. Sampled hourly for the first day, then daily, then weekly, then never: a post stops growing and the polling stops with it. Empty until the first snapshot, and always empty where analytics is "none".

Behavior

HTTP: GET /content/metrics/posts/:id

Arguments

Name	Type	Required	Description
id	string	•	The publication id, from content_publications_schedule or content_publications_list.
to	string	—	ISO-8601 upper bound on capture time, inclusive. Omit for "up to now".
from	string	—	ISO-8601 lower bound on capture time, inclusive. Omit for "from the beginning".
limit	integer	—	Maximum number of snapshots to return, oldest first.

Response

Field	Type	Always	Description
latest	object	•	The newest snapshot as flat, named numbers — what to read when you want "how is this post doing" rather than the whole curve. Null when nothing has been captured yet.
points	array	•	Snapshots oldest first. Readings over time, not a current value: reach keeps growing for weeks. Empty means nothing has been captured yet.
network	string	•	The network the channel publishes to. "unknown" means the channel behind this publication can no longer be read — the publication outlives the channel binding.
analytics	string	•	What this network reports for this account. "none" means no snapshot will ever be taken — a personal Instagram profile has no API at all; "basic" means fewer numbers than a business account gets, so an absent metric is the network's silence, not a zero.
channelId	string	•	The channel it was published to.
publicationId	string	•	The publication these snapshots belong to.

Try it

Metric snapshots of one published post on one channel, over time — how reach and engagement grew, not a single current number.

When to use

Example

Ask your agent something like this:

Metric snapshots of one published post on one channel, over time — how reach and engagement grew, not a single current number.

The agent will invoke content_metrics_post_series with these arguments:

{
  "id": "<id>"
}