Platform insights

Every platform exposes a different set of numbers. Pozy normalises them into one analytics object per post, then adds account-level endpoints for the platforms that offer more. This page lists what you can count on from each.

#Post metrics by platform

GET /v1/analytics?platform=<id> returns these fields per post. A dash means the platform does not report it, so the field reads 0 or null.

"Business" means accounts connected through TikTok's business app, which every new TikTok connection uses.

#Platform notes

• Instagram. Post reach and impressions can take about a day to settle. Image and cover URLs in analytics responses are served from Pozy storage once the platform's own links expire, so you can cache them.
• Facebook. likes is the total of all reaction types. Post reactions splits it by type. Page stories are collected while live and keep their last reading after 24 hours.
• TikTok. Business connections also report watch time, completion rate, profile views, new followers, website clicks, impression sources, audience types, audience countries and a retention curve. TikTok fills these 24 to 48 hours after publishing and only for posts active in the last 7 days, so a fresh post shows zeros at first. Account-level impressions and reach do not exist on any TikTok API.
• YouTube. Per-day shares come from daily views. Thumbnail impressions and click-through rate are not available through YouTube's API.
• LinkedIn. Personal profiles only return metrics for posts published through Pozy, because LinkedIn reports only on posts the member authored through the app. Company pages report every post.
• X. views is the media view count, so text and image posts read 0. Every X read is billed per call; see pricing.
• Threads. There is no impressions metric; use views as reach. shares adds reposts and quotes together.
• Pinterest. views counts video views, so image pins read 0.
• Snapchat. Metrics come per content type (story, saved story, spotlight). Snapchat has no likes, comments or saves.
• Reddit. Reddit closed its API to third-party apps. Reddit analytics keep their last synced values and stop updating until access returns.
• Google Business Profile. Google retired per-post insights, so posts carry no metrics. Use the location performance endpoints below.

#Account-level insights

Most account endpoints share the same query shape: accountId, fromDate and toDate (defaults to the last 30 days, at most about 90), metrics as a comma-separated list, and metricType as total_value (default) or time_series.

curl "https://api.pozy.ai/v1/analytics/instagram/account-insights?accountId=6650c1e2a3b4c5d6e7f80a22&metrics=reach&metricType=time_series&fromDate=2026-10-01&toDate=2026-10-28" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/analytics/instagram/account-insights?accountId=6650c1e2a3b4c5d6e7f80a22&metrics=reach&metricType=time_series&fromDate=2026-10-01&toDate=2026-10-28", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data);

import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/analytics/instagram/account-insights",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"accountId": "6650c1e2a3b4c5d6e7f80a22", "metrics": "reach", "metricType": "time_series"},
    timeout=30,
)
print(resp.json())

#Instagram

#Facebook

#YouTube

#LinkedIn

#TikTok

GET /v1/analytics/tiktok/account-insights returns follower_count, following_count, likes_count and video_count, plus followers_gained and followers_lost from Pozy's daily snapshots. Richer numbers are per video: see the TikTok row in the table above.

#Google Business Profile

#Google Analytics

A connected Google Analytics property can be queried with POST /v1/analytics/googleanalytics/report and its realtime variant. List valid dimensions and metrics first with GET /v1/analytics/googleanalytics/metadata. See Google Analytics.

#Missing permissions

When an account was connected before a platform permission existed, account endpoints answer 412 with a hint to reauthorize (YouTube Analytics, TikTok stats, LinkedIn page analytics). Send the user through reconnect and retry.

#Endpoints