Post Stat

Overview

Represents engagement statistics for an individual post at a specific point in time.

Fields

Field	Type	Description
`id`	`string`	Unique stat record identifier
`post_id`	`string`	Associated post ID
`views`	`number \| null`	View count at the time of recording
`likes`	`number \| null`	Like count at the time of recording
`comments`	`number \| null`	Comment count at the time of recording
`shares`	`number \| null`	Share count at the time of recording
`created_at`	`string`	ISO 8601 timestamp when stat was recorded

How Post Stats Work

Post stats are snapshots in time. Multiple stat records may exist for a single post, allowing you to track performance over time.

Creating Stats

Post stats are automatically created when you use the /stats/refresh endpoint:

Fetches fresh statistics from TikTok/Instagram API
Creates a new post_stats record for each post
Each record includes a timestamp for historical tracking

Time-Series Data

The time-series nature of post stats allows you to:

Track how a post performs over its lifetime
Identify viral growth patterns
Compare early vs. late performance
Generate trend reports

Engagement Metrics

Metric	Description
`views`	Number of times the post was viewed
`likes`	Number of likes/hearts the post received
`comments`	Number of comments on the post
`shares`	Number of times the post was shared

Example Response

{
  "id": "pstat_abc123",
  "post_id": "post_123456",
  "views": 125000,
  "likes": 8950,
  "comments": 342,
  "shares": 567,
  "created_at": "2024-12-25T10:00:00Z"
}

Use Cases

Monitor individual post performance
Track engagement growth over time
Identify top-performing content
Calculate engagement rates
Generate performance reports

Getting Started

Data Structures

Posts

Comments

Accounts

Statistics

Tasks

Organization

Media

Billing

Automations

Overview

Fields

How Post Stats Work

Creating Stats

Time-Series Data

Engagement Metrics

Example Response

Use Cases

​Overview

​Fields

​How Post Stats Work

​Creating Stats

​Time-Series Data

​Engagement Metrics

​Example Response

​Use Cases

Overview

Fields

How Post Stats Work

Creating Stats

Time-Series Data

Engagement Metrics

Example Response

Use Cases