Analytics
The Threads post metrics returned by the analytics endpoints and the errors they report.
Read views, likes, replies and shares for any Threads post of a connected profile. The connection needs the threads_manage_insights permission.
Metrics
| Field | Threads metric | Notes |
|---|---|---|
impressions | views | |
reach | None | Always null |
plays | views | Same value as impressions |
likes | likes | |
comments | replies | |
shares | shares | When Threads does not report shares, the sum of reposts and quotes |
saves | None | Always null |
engagement | Calculated | likes + comments + shares |
A metric Threads does not return for a post is null, not 0.
Read Post Analytics
Pass the Onepostly post id, or the Threads post id plus accountId for a post published outside Onepostly. See Targeting Posts.
import { Configuration, AnalyticsApi } from "@onepostly/sdk";
const analyticsApi = new AnalyticsApi(
new Configuration({ apiKey: process.env.ONEPOSTLY_API_KEY })
);
const response = await analyticsApi.getAnalytics({
post: "1699f415-7fb6-43f4-9d2a-c447491f32a8",
metrics: "views,reach,profile_views",
period: "day",
});
console.log(response);{
"analytics": {
"post": "1699f415-7fb6-43f4-9d2a-c447491f32a8",
"status": "ready",
"fetchedAt": "2026-08-25T10:00:00.000Z",
"subjects": [
{
"scope": "destination",
"subjectId": "d4e5f6a7-8b9c-4d0e-8f1a-2b3c4d5e6f7a",
"accountId": "a1b2c3d4-e5f6-4a7b-8c9d-e0f1a2b3c4d5",
"platform": "threads",
"externalPostId": "17895695668004550",
"status": "ready",
"metrics": {
"impressions": 1234,
"reach": null,
"likes": 123,
"comments": 12,
"shares": 4,
"saves": null,
"plays": 456,
"engagement": 0.14
},
"fetchedAt": "2026-08-25T10:00:00.000Z",
"expiresAt": "2026-09-01T10:00:00.000Z",
"error": null,
"externalUrl": "https://www.threads.com/@you/post/17895695668004550"
}
]
}
}For day-by-day values, use the Daily Timeline.
Analytics Status
A post that has just been published reports pending until Threads returns its first metrics. The meaning of every status is in Analytics Status.
Errors
These codes appear in subjects[].error.code.
| Code | Cause | Fix |
|---|---|---|
NOT_PUBLISHED | The Threads destination is not published yet | Read analytics after post.platform.published |
ANALYTICS_PERMISSION | The connection lacks threads_manage_insights | Reconnect the account and approve every permission |
ANALYTICS_FAILED | Threads returned an error for this post | Read error.message; check that the post still exists on Threads |
ANALYTICS_UNAVAILABLE | Threads returned no metrics for this post | Read analytics again later |