Analytics

Track post performance and account growth across all connected platforms. Metrics are collected per post and aggregated into overviews with date-range filtering.

Overview

GET /v1/analytics/overview

Returns totals, per-platform breakdown, top 5 posts by engagement, and a daily time-series. Default range is last 30 days.

curl "https://api.letspost.app/v1/analytics/overview?profileId=prof_abc&startDate=2026-04-01&endDate=2026-04-30" \
  -H "Authorization: Bearer $SOCIALHUB_KEY"

Response shape

{
  "period": { "start": "2026-04-01", "end": "2026-04-30" },
  "totalPosts": 42,
  "totalViews": 128400,
  "totalLikes": 3200,
  "totalComments": 410,
  "totalShares": 890,
  "avgEngagementRate": 3.51,
  "byPlatform": {
    "youtube":   { "posts": 15, "views": 80000, ... },
    "instagram": { "posts": 14, "views": 35000, ... },
    "tiktok":    { "posts": 13, "views": 13400, ... }
  },
  "topPosts": [ ... ],
  "dailyTrend": [
    { "date": "2026-04-01", "views": 4200, "likes": 120, ... },
    ...
  ]
}

Per-post metrics

GET /v1/analytics/posts/{postId}

Returns an array of metric snapshots — one per platform the post was published to.

curl https://api.letspost.app/v1/analytics/posts/pst_123 \
  -H "Authorization: Bearer $SOCIALHUB_KEY"

Fields per entry

Account metrics

GET /v1/analytics/accounts

Follower counts and totals for every connected account. Useful for tracking audience growth over time.

curl https://api.letspost.app/v1/analytics/accounts \
  -H "Authorization: Bearer $SOCIALHUB_KEY"