Post analytics

GET /v1/analytics returns your posts with their metrics. Without postId it is a paginated list with an overview block. With postId it returns one post and a breakdown per platform it went to.

#List posts with metrics

curl "https://api.pozy.ai/v1/analytics?profileId=6650c1e2a3b4c5d6e7f80911&fromDate=2026-09-01&sortBy=engagement&limit=50" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/analytics?profileId=6650c1e2a3b4c5d6e7f80911&fromDate=2026-09-01&sortBy=engagement&limit=50", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

for (const post of data.posts) {
  console.log(post.platform, post.analytics.likes, post.analytics.engagementRate);
}

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/analytics",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"profileId": "6650c1e2a3b4c5d6e7f80911", "fromDate": "2026-09-01", "sortBy": "engagement", "limit": 50},
    timeout=30,
)
for post in resp.json()["posts"]:
    print(post["platform"], post["analytics"]["likes"])

{
  "overview": {
    "totalPosts": 142,
    "publishedPosts": 140,
    "scheduledPosts": 2,
    "lastSync": "2026-10-29T21:12:00Z",
    "dataStaleness": { "staleAccountCount": 0, "syncTriggered": false }
  },
  "posts": [
    {
      "_id": "6650c1e2a3b4c5d6e7f80e66",
      "platform": "instagram",
      "status": "published",
      "publishedAt": "2026-10-02T14:00:03Z",
      "platformPostUrl": "https://www.instagram.com/p/C7xYz12AbCd/",
      "analytics": { "impressions": 4210, "reach": 3105, "likes": 312, "comments": 41, "shares": 18, "saves": 27, "views": 3890, "engagementRate": 9.33, "lastUpdated": "2026-10-29T21:12:00Z" },
      "platforms": [{ "platform": "instagram", "syncStatus": "synced" }]
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 142, "pages": 3 }
}

#Filters and sorting

A post sent to several platforms appears once per platform in the list, so key your own rows on post id plus platform.

#The metrics

Every post carries the same analytics object. A metric a platform does not report is 0 or null; check Platform insights for what each platform fills in.

#One post across platforms

Pass postId (a Pozy post id or an external post id) to get a single post with a platformAnalytics array, one entry per platform it was published to:

curl "https://api.pozy.ai/v1/analytics?postId=6650c1e2a3b4c5d6e7f80e66" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/analytics?postId=6650c1e2a3b4c5d6e7f80e66", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

for (const p of data.platformAnalytics) {
  console.log(p.platform, p.syncStatus, p.analytics?.views);
}

resp = requests.get(
    "https://api.pozy.ai/v1/analytics",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"postId": "6650c1e2a3b4c5d6e7f80e66"},
    timeout=30,
)
print(resp.json()["platformAnalytics"])

Each platformAnalytics entry has its own syncStatus (synced, pending, unavailable), platformPostUrl and, when something went wrong, errorCode: post_not_found (deleted on the platform), not_post_owner or permission_missing.

#Day by day

Two endpoints give you a time series instead of lifetime totals.

One post over time. GET /v1/analytics/post-timeline with postId returns one row per day per platform, showing how impressions, likes and the other counters grew since publishing.

All posts, summed per day. GET /v1/analytics/daily-metrics returns a dailyData array (post count, platform split and summed metrics per day) plus a platformBreakdown. It defaults to the last 180 days. Its attribution parameter decides what a day means:

A post published on 1 July gets 40 likes that day and 10 more on 20 July. Under publish, all 50 sit on 1 July. Under received, 1 July shows 40 and 20 July shows 10. Use received for account overview charts, because it moves even in weeks with no new posts.

#Followers

Follower counts live on the accounts side: GET /v1/accounts/follower-stats takes profileId or accountIds, a date range and granularity (daily, weekly or monthly). Counts refresh once a day, so a daily job is enough.

#Exports

There is no separate export endpoint. To export, page through GET /v1/analytics (100 posts per page) or the delta feed and write the rows to CSV yourself. Each row already has the post URL, platform, publish time and every metric.

#Endpoints