Analytics · Analytics
Opens a tracking window.
POST
https://api.pozy.ai/v1/analytics/trackingInstagram, Facebook, TikTok, YouTube, X and Threads and 5 moreopenTrackingWindow
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys cannot call it. Keys with the analytics resource group disabled get 403 resource_group_disabled. Authentication
Request body
application/json, required
postIdstringaccountIdstringurlstringtrackingDaysintegerDefault
30. 1 to 90.requestedBystringDefault
api.
Example
curl -X POST "https://api.pozy.ai/v1/analytics/tracking" \
-H "Authorization: Bearer $POZY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"postId": "6108a2cc742cb4e991051e0c",
"accountId": "696e0b682d0a31188e7a2ba9",
"url": "https://pozy.ai/media/example-1.jpg",
"trackingDays": 30
}'const res = await fetch("https://api.pozy.ai/v1/analytics/tracking", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.POZY_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
postId: "6108a2cc742cb4e991051e0c",
accountId: "696e0b682d0a31188e7a2ba9",
url: "https://pozy.ai/media/example-1.jpg",
trackingDays: 30
}),
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.post(
"https://api.pozy.ai/v1/analytics/tracking",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
json={
"postId": "6108a2cc742cb4e991051e0c",
"accountId": "696e0b682d0a31188e7a2ba9",
"url": "https://pozy.ai/media/example-1.jpg",
"trackingDays": 30,
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
windowobjectrequired12 child fields
idstringrequiredpostIdstringrequiredaccountIdstringrequiredplatformstringrequiredplatformPostIdstringrequiredstartsAtstring (date-time)requiredendsAtstring (date-time)requiredstatusstringrequiredOne of
open,completing,completed,cancelled.finalReadAtstring (date-time)requiredCan be null.
completionReasonstringrequiredOne of
final_read,unreachable,post_deleted,cancelled. Can be null.requestedBystringrequiredlatestobjectrequiredCan be null.
6 child fields
viewsintegerrequiredlikesintegerrequiredcommentsintegerrequiredsharesintegerrequiredsavesintegerrequiredsyncedAtstring (date-time)requiredCan be null.
200 response
{
"window": {
"id": "6bfebd43ddc270f6d2c56fc5",
"postId": "6108a2cc742cb4e991051e0c",
"accountId": "696e0b682d0a31188e7a2ba9",
"platform": "instagram",
"platformPostId": "637f799b3039e6602e83fa4f",
"startsAt": "2026-10-02T09:00:00.000Z",
"endsAt": "2026-10-02T09:00:00.000Z",
"status": "open",
"finalReadAt": "2026-10-02T09:00:00.000Z",
"completionReason": "final_read",
"requestedBy": "string",
"latest": {
"views": 1,
"likes": 1,
"comments": 1,
"shares": 1,
"saves": 1,
"syncedAt": "2026-10-02T09:00:00.000Z"
}
}
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is read-only, scoped to other profiles, or has this resource group disabled. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in Analytics
GETGet post analyticsGETAnalytics changed since a cursorGETGet YouTube channel insightsGETGet LinkedIn org analyticsGETGet TikTok account-level insightsGETGet YouTube daily viewsGETGet YouTube video retention curveGETGet Facebook Page insightsGETGet Facebook post monetization earningsGETGet Instagram insightsGETGet Instagram follower historyGETGet Facebook Page demographicsGETGet LinkedIn organization follower demographicsGETGet Instagram demographicsGETGet Instagram online followersGETGet YouTube demographicsGETGet daily aggregated metricsGETGet an analytics dashboardGETGet best times to postGETGet content performance decayGETGet frequency vs engagementGETGet post analytics timelinePOSTRun a Google Analytics (GA4) reportPOSTRun a Google Analytics (GA4) realtime reportGETList Google Analytics (GA4) dimensions and metricsGETList tracking windowsGETGet a tracking windowDELCancel a tracking windowGETGet post samplesGETGet a post's authenticity scoreGETList authenticity scoresGETGet Google Business Profile performance metricsGETGet Google Business Profile search keywordsPOSTSync an external postGETGet LinkedIn aggregate statsGETGet LinkedIn post statsGETGet LinkedIn post reactionsGETGet Facebook post reactionsGETList visitor posts on a Facebook PageGETList the posts a Facebook Page is tagged in