Analytics Summary — GET /v1/analytics/summary

Returns aggregate counts for a time window. Answers questions like "how many posts have I published this month?" or "which platform has the most failures this week?" without listing every post and counting client-side.

Request: GET /v1/analytics/summary

curl "https://app.posteverywhere.ai/api/v1/analytics/summary?period=week" \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY"

Parameters

Param	Values	Default
period	today (24 h), week (7 d), month (30 d), all, custom	month
from	ISO timestamp (required if period=custom)	—
to	ISO timestamp (required if period=custom)	—

Response: totals, per-platform, and metrics coverage

{
  "period": "week",
  "range":  { "from": "2026-06-04T05:30:00Z", "to": "2026-06-11T05:30:00Z" },

  "posts": {
    "total":             214,
    "draft":             3,
    "scheduled":         168,
    "publishing":        2,
    "published":         33,
    "partially_failed":  4,
    "failed":            4
  },

  "by_platform": [
    { "platform": "instagram", "total": 67, "scheduled": 55, "published": 11, "failed": 1 },
    { "platform": "tiktok",    "total": 41, "scheduled": 38, "published": 0, "failed": 3 },
    { "platform": "linkedin",  "total": 38, "scheduled": 30, "published": 8, "failed": 0 }
  ],

  "metrics": {
    "views":       12483,
    "likes":       872,
    "comments":    143,
    "shares":      29,
    "impressions": 41208,
    "clicks":      518
  },

  "ai_credits": {
    "used_this_period": 138,
    "bonus":            0
  }
}

Metric coverage per platform

• posts.total counts unique post groups. Multi-platform posts count as one here, not one per destination.
• by_platform.total counts destinations, so a 5-platform post contributes 5 rows total.
• metrics aggregates only the published destinations. Failed destinations don't have metrics.
• Status counts use the derived post status, the same as GET /v1/posts's status filter (scheduled / publishing / published / partially_failed / failed / draft).

Status derivation

Post status is derived live from the destinations underneath it. Note the vocabulary shift: a destination that published successfully is done, never published. See the two status vocabularies.

• published — every destination is done
• failed — at least 1 destination failed, none done, none queued
• partially_failed — at least 1 destination done AND at least 1 failed
• publishing — at least 1 destination is in flight (preparing / uploading / publishing / verifying)
• scheduled — at least 1 destination queued and nothing published yet
• draft — posts.post_status = 'draft'

Which metrics each platform actually returns

The metrics block is only as complete as what each platform's API gives us back, and that varies a lot. Read this before building a dashboard on it, so a zero reads as "this platform does not report it" rather than "this post got nothing".

Platform	Views	Likes	Comments	Shares	Impressions	Notes
YouTube	yes	yes	yes	-	-	Most complete source
TikTok	yes	yes	yes	yes	-	Live since Jul 28 2026. Accounts connected before Jul 3 2026 must reconnect once to grant the analytics scope
Pinterest	yes	yes	-	yes	yes	Saves reported as shares
LinkedIn	-	yes	yes	-	yes	LinkedIn exposes no view count for posts
Instagram	-	yes	yes	-	-	Insights pending Meta App Review
X	-	yes	-	yes	yes	Refreshed on demand only (each read costs API credits), press Refresh on the analytics page
Bluesky	-	yes	-	-	-
Facebook	-	-	-	-	-	Blocked on pages_read_engagement Advanced Access, pending Meta App Review
Threads	-	-	-	-	-	Blocked on threads_manage_insights, pending Meta App Review
Telegram, Discord	-	-	-	-	-	No per-post analytics available for these integrations

A field we do not receive is returned as 0 in the aggregate and null on the individual destination, so null is the honest signal for "not reported".

Reach and follower growth are not available

The API exposes no reach metric and no follower counts or follower growth, on any platform. impressions is the closest available measure and is not the same thing. If you need either, tell us at [email protected] so we can weight the work.

Full reference: GET /v1/analytics/summary.