v3

latestOpenAPI 3.0.1Proprietary2026-07-314140169.7 KB

Platform Integration

Get cached per-post analytics

Replays per-post metrics that Upload-Post already fetched, instead of calling the social platforms again. Because it never touches the platforms during the request, it is NOT subject to the platform analytics rate limit of 100 requests / 5 minutes that applies to the live /uploadposts/post-analytics endpoints, and it is paginated — built for re-reading a large back catalogue. IMPORTANT: this is a write-through cache filled as a side effect of live reads. A post appears here only after it has been fetched at least once through a live per-post endpoint, and there is no background refresh — captured_at is the last time that post was read live. To refresh a post, call the live endpoint for it.

get/uploadposts/post-analytics/cached

Query parameters

userstring required

The profile_username of the profile to read snapshots for.

Restrict the result to a single platform. When omitted, all platforms are returned and the response echoes platform: null.

limitinteger

Number of posts per page. Defaults to 50, maximum 200.

cursorstring

Opaque next-page token. Pass back exactly the value returned in next_cursor by the previous response. An invalid cursor returns 400.

sincestring date

Start of the date range in YYYY-MM-DD format. Defaults to 30 days ago.

untilstring date

End of the date range in YYYY-MM-DD format. Defaults to today.

Response

Cached post analytics retrieved successfully.

successboolean

profile_usernamestring

platformstring nullable

The platform filter applied, or null when none was requested.

sincestring date

untilstring date

sourcestring

Always 'snapshot_cache' — a marker that these numbers came from the daily snapshot, not a live platform call.

limitinteger

The effective page size applied.

next_cursorstring nullable

Token to pass as 'cursor' on the next request. Null when there are no more pages.

has_moreboolean

Example response

{
  "source": "snapshot_cache"
}