Analytics
Get Post Analytics Timeline
Returns a post's metrics day by day, one point per UTC day. Covers the last 90 days by default, and at most 90 days. Not available for X posts.
GET
Bearerheader
AuthorizationBearer <op_>Workspace API key, sent as Authorization: Bearer op_... Keys are created in the dashboard.
id*stringLength
1 <= lengthsince?stringStart of the range. The first day covered is the UTC day it falls on. Defaults to 90 days before until.
Format
date-timeuntil?stringEnd of the range. The last day covered is the UTC day the range ends in. Defaults to now.
Format
date-timeDaily metrics
application/json- response
postId*stringfrom*stringFirst UTC day of the timeline.
Format
dateto*stringLast UTC day of the timeline.
Format
datepoints*array<>One point per UTC day with a reading. A day without a reading has no point.
Example Request
import { Configuration, AnalyticsApi } from "@onepostly/sdk";const analyticsApi = new AnalyticsApi( new Configuration({ accessToken: process.env.ONEPOSTLY_API_KEY }));const response = await analyticsApi.getPostAnalyticsTimeline({ id: "pst_3c8a2d6e91b44f7a8e250d6b4c1f9a73", since: "2027-03-01T00:00:00Z", until: "2027-03-29T00:00:00Z",});console.log(response);Example Response
{ "postId": "pst_3c8a2d6e91b44f7a8e250d6b4c1f9a73", "from": "2027-03-01", "to": "2027-03-28", "points": [ { "day": "2027-03-15", "metrics": { "impressions": 310, "reach": 262, "likes": 28, "comments": 3, "shares": 1, "saves": 0, "views": 310, "engagement": 32 }, "delta": { "impressions": null, "reach": null, "likes": null, "comments": null, "shares": null, "saves": null, "views": null, "engagement": null } }, { "day": "2027-03-16", "metrics": { "impressions": 1980, "reach": 1610, "likes": 141, "comments": 13, "shares": 5, "saves": 3, "views": 1980, "engagement": 162 }, "delta": { "impressions": 1670, "reach": 1348, "likes": 113, "comments": 10, "shares": 4, "saves": 3, "views": 1670, "engagement": 130 } }, { "day": "2027-03-17", "metrics": { "impressions": 2650, "reach": 2140, "likes": 182, "comments": 17, "shares": 6, "saves": 4, "views": 2650, "engagement": 209 }, "delta": { "impressions": 670, "reach": 530, "likes": 41, "comments": 4, "shares": 1, "saves": 1, "views": 670, "engagement": 47 } }, { "day": "2027-03-18", "metrics": { "impressions": 3040, "reach": 2450, "likes": 207, "comments": 19, "shares": 7, "saves": 5, "views": 3040, "engagement": 238 }, "delta": { "impressions": 390, "reach": 310, "likes": 25, "comments": 2, "shares": 1, "saves": 1, "views": 390, "engagement": 29 } }, { "day": "2027-03-19", "metrics": { "impressions": 3290, "reach": 2650, "likes": 223, "comments": 21, "shares": 8, "saves": 6, "views": 3290, "engagement": 258 }, "delta": { "impressions": 250, "reach": 200, "likes": 16, "comments": 2, "shares": 1, "saves": 1, "views": 250, "engagement": 20 } }, { "day": "2027-03-20", "metrics": { "impressions": 3450, "reach": 2780, "likes": 233, "comments": 22, "shares": 8, "saves": 6, "views": 3450, "engagement": 269 }, "delta": { "impressions": 160, "reach": 130, "likes": 10, "comments": 1, "shares": 0, "saves": 0, "views": 160, "engagement": 11 } }, { "day": "2027-03-21", "metrics": { "impressions": 3570, "reach": 2870, "likes": 240, "comments": 23, "shares": 9, "saves": 7, "views": 3570, "engagement": 279 }, "delta": { "impressions": 120, "reach": 90, "likes": 7, "comments": 1, "shares": 1, "saves": 1, "views": 120, "engagement": 10 } }, { "day": "2027-03-22", "metrics": { "impressions": 3660, "reach": 2940, "likes": 245, "comments": 23, "shares": 9, "saves": 7, "views": 3660, "engagement": 284 }, "delta": { "impressions": 90, "reach": 70, "likes": 5, "comments": 0, "shares": 0, "saves": 0, "views": 90, "engagement": 5 } }, { "day": "2027-03-23", "metrics": { "impressions": 3730, "reach": 2990, "likes": 249, "comments": 24, "shares": 9, "saves": 7, "views": 3730, "engagement": 289 }, "delta": { "impressions": 70, "reach": 50, "likes": 4, "comments": 1, "shares": 0, "saves": 0, "views": 70, "engagement": 5 } }, { "day": "2027-03-24", "metrics": { "impressions": 3780, "reach": 3030, "likes": 252, "comments": 24, "shares": 9, "saves": 8, "views": 3780, "engagement": 293 }, "delta": { "impressions": 50, "reach": 40, "likes": 3, "comments": 0, "shares": 0, "saves": 1, "views": 50, "engagement": 4 } }, { "day": "2027-03-25", "metrics": { "impressions": 3820, "reach": 3060, "likes": 254, "comments": 24, "shares": 10, "saves": 8, "views": 3820, "engagement": 296 }, "delta": { "impressions": 40, "reach": 30, "likes": 2, "comments": 0, "shares": 1, "saves": 0, "views": 40, "engagement": 3 } }, { "day": "2027-03-26", "metrics": { "impressions": 3850, "reach": 3080, "likes": 256, "comments": 25, "shares": 10, "saves": 8, "views": 3850, "engagement": 299 }, "delta": { "impressions": 30, "reach": 20, "likes": 2, "comments": 1, "shares": 0, "saves": 0, "views": 30, "engagement": 3 } }, { "day": "2027-03-27", "metrics": { "impressions": 3870, "reach": 3095, "likes": 257, "comments": 25, "shares": 10, "saves": 8, "views": 3870, "engagement": 300 }, "delta": { "impressions": 20, "reach": 15, "likes": 1, "comments": 0, "shares": 0, "saves": 0, "views": 20, "engagement": 1 } }, { "day": "2027-03-28", "metrics": { "impressions": 3890, "reach": 3105, "likes": 258, "comments": 25, "shares": 10, "saves": 8, "views": 3890, "engagement": 301 }, "delta": { "impressions": 20, "reach": 10, "likes": 1, "comments": 0, "shares": 0, "saves": 0, "views": 20, "engagement": 1 } } ]}Get Post Analytics
Returns a post's lifetime metrics. Metrics refresh about hourly for posts under 30 days old and about weekly after that. X metrics are read when you ask and charged to the wallet, at most once per post and UTC day. Later requests that day return the same reading at no charge.
Get Account Analytics
Returns account-level insights, read live from the platform. Available for Instagram professional accounts and Facebook Pages.