Skip to main content

​
Overview

Represents statistics for an account at a specific point in time.

​
Fields

FieldTypeDescription
idstringUnique stat record identifier
account_idstringAssociated account ID
followersnumber | nullFollower count at the time of recording
followingnumber | nullFollowing count at the time of recording
viewsnumber | nullTotal content views across all posts
likesnumber | nullTotal likes received across all posts
created_atstringISO 8601 timestamp when stat was recorded

​
How Account Stats Work

Account stats are created by aggregating post-level metrics. The views and likes fields represent totals across all posts associated with the account.

​
Creating Stats

Use the /stats/refresh endpoint to fetch fresh statistics from the TikTok/Instagram API:
  1. Fetches account profile stats (followers, following)
  2. Fetches stats for all posts associated with the account
  3. Creates an account_stats record with aggregated post metrics
  4. Creates individual post_stats records for each post

​
Time-Series Data

Multiple stat records can exist for a single account, allowing you to track growth and performance over time. Each record includes a created_at timestamp indicating when the snapshot was taken.

​
Example Response

{
  "id": "stat_abc123",
  "account_id": "acc_123456",
  "followers": 15420,
  "following": 342,
  "views": 1250000,
  "likes": 89500,
  "created_at": "2024-12-25T10:00:00Z"
}

​
Use Cases

  • Track follower growth over time
  • Monitor total engagement across all content
  • Compare performance across accounts
  • Generate analytics reports