Read posts and metrics
Read synchronized posts and interpret metrics across platforms.
List published posts
curl --request GET "https://www.posteady.com/api/v1/posts?provider=threads&limit=20&sort=recent" \
--header "Authorization: Bearer $POSTEADY_API_KEY"| Parameter | Meaning |
|---|---|
provider | Filter by platform; omit for all supported platforms |
accountId | Filter by account UUID |
limit | 1–100; default 20 |
sort | recent (default) for newest first; top for highest views |
The response includes posts, totalMatched, and rangeDays. The window is fixed to the last 90 days from now; there are no date-range, offset, or cursor parameters. totalMatched is the count before the limit and can exceed the returned array length.
Post IDs and content
postId is the native platform ID, not a Posteady database UUID. content is a preview up to 280 characters. Use accountId and username to identify the account, and permalink and postedAt for location and time. A native ID does not imply repost support.
Interpret metrics
This API reads data already synchronized to Posteady; it does not refresh the platform on request. When available, metricsUpdatedAt indicates freshness. Do not replace null with zero.
| Platform | Metrics and differences |
|---|---|
| Threads, X, LinkedIn | views, likes, replies, reposts, quotes, and bookmarks are numbers; the existing contract fills missing values with 0 |
| TikTok | Views, likes, comments (replies), and shares are numbers or null. reposts, quotes, and bookmarks are null |
views represents impressions, reach is reach, replies are comments, and bookmarks are saves. Likes/comments can exist independently of insights. reposts and quotes are null | |
| YouTube | views, likes, and replies (comments) are numbers or null. Shares, reposts, quotes, and bookmarks are null |
views is post_media_view, replies are comments, and the share count appears in both shares and reposts. Reach, quotes, and bookmarks are null |
When TikTok metricsUpdatedAt is null, views, likes, comments, and shares are all null. Historical cached zeros can remain until the next sync. Facebook shares and reposts represent the same count; adding them would double-count shares.
Included posts
TikTok includes videos and photos with native IDs, excluding inbox transfers, processing records, and private records without native IDs. Instagram reads synchronized professional-account posts; YouTube includes videos and SHORTS with native IDs; Facebook includes non-deleted Page posts.