Analytics

Pull engagement metrics, follower growth, and reach data for any account on any platform. Metrics are normalized into a consistent format.

POST/v1/social/analytics

Example request

stats = client.analytics(
    platform="x",
    handle="wallstreetbets",
    period="7d"
)

print(f"Reach: {stats.summary.total_reach:,}")
print(f"Engagement: {stats.summary.engagement_rate}%")
print(f"Follower change: +{stats.summary.follower_change:,}")

print("\nTop posts:")
for post in stats.top_posts[:3]:
    print(f"  {post.engagement:,} - {post.text[:60]}")

Request body

Field	Type	Description
platformrequired	string	Target platform: x, reddit, instagram, tiktok, discord, telegram, youtube.
handlerequired	string	Account handle without prefix. e.g. 'wallstreetbets', not 'r/wallstreetbets'.
period	string	Time window: 24h, 7d, 30d, 90d. Default: 7d.
metrics	string[]	Specific metrics to return. Default: all available. Options: impressions, engagement, followers, reach, posts.

Example body

{
  "platform": "x",
  "handle": "wallstreetbets",
  "period": "7d",
  "metrics": ["impressions", "engagement", "followers"]
}

Response

Field	Type	Description
summary	object	Aggregate metrics across the entire period.
summary.total_reach	integer	Estimated unique impressions across the period.
summary.total_engagement	integer	Sum of likes, comments, shares, saves, and other interactions.
summary.engagement_rate	number	Engagement as percentage of reach. e.g. 7.3 = 7.3%.
summary.follower_count	integer	Current follower count at end of period.
summary.follower_change	integer	Net change in followers across the period (can be negative).
summary.post_count	integer	Number of posts published during the period.
timeseries	array	Daily breakdown of reach and engagement.
top_posts	array	Top 5 posts by engagement during the period.
credits_used	number	Credits consumed for this query.

Example response

{
  "platform": "x",
  "handle": "wallstreetbets",
  "period": "7d",
  "summary": {
    "total_reach": 4280000,
    "total_engagement": 312450,
    "engagement_rate": 7.3,
    "follower_count": 248000,
    "follower_change": 1240,
    "post_count": 47
  },
  "timeseries": [
    { "date": "2026-04-19", "reach": 580000, "engagement": 42100 },
    { "date": "2026-04-20", "reach": 612000, "engagement": 48200 }
  ],
  "top_posts": [
    {
      "id": "1234567890",
      "text": "Best take I've seen all week",
      "engagement": 28400,
      "url": "https://x.com/wallstreetbets/status/1234567890"
    }
  ],
  "credits_used": 0.002
}