List posts
Read published posts and the engagement metrics available for each platform.
curl -X GET "https://example.com/api/v1/posts?provider=threads&accountId=11111111-1111-4111-8111-111111111111&limit=20&sort=recent&since=2026-10-01T00%3A00%3A00Z&until=2026-11-01T00%3A00%3A00Z&offset=0"{ "posts": [ { "postId": "18000000000000001", "platform": "threads", "type": "post", "accountId": "11111111-1111-4111-8111-111111111111", "username": "your_brand", "content": "Hello from the Posteady API!", "permalink": "https://www.threads.net/@your_brand/post/example", "postedAt": "2026-09-07T12:00:00Z", "metrics": { "views": 240, "likes": 12, "replies": 2, "reposts": 1, "quotes": 0, "bookmarks": 0 } } ], "totalMatched": 1, "hasMore": false, "since": "2026-06-10T00:00:00.000Z", "until": "2026-09-08T00:00:00.000Z", "rangeDays": 90}List posts from Threads, X, LinkedIn, TikTok, Instagram, YouTube, and Facebook. TikTok support is limited to accounts connected through TikTok for Business Developers; this names the connection method, not the TikTok account type. Login Kit connections are excluded. TikTok results use data already synchronized to Posteady and include video and photo posts with a native post ID. Inbox transfers, processing records, and private records without a native post ID are excluded. See metricsUpdatedAt for TikTok metric freshness. TikTok supports public video publishing and scheduling; photo publishing and reposting are not supported. Instagram results also use locally synchronized professional-account data; this request does not trigger a live platform refresh. YouTube results use locally synchronized channel videos with a native video ID and include title and mediaType (VIDEO or SHORTS); see metricsUpdatedAt for freshness. Facebook results use locally synchronized, non-deleted Page posts and include mediaType; this request does not trigger a live Graph refresh. Threads, X, and LinkedIn results mark reposts with type repost. A repost's metrics are null, and repostOf names the original author and link when known. By default the request reads the last 90 days. Pass since and until to read another period of up to 90 days. While hasMore is true, request the next page with offset. Send the until from the first response with every page so that new posts do not shift the pages.
Authorization
apiKey In: header
Query parameters
Value in
- "threads"
- "x"
- "linkedin"
- "tiktok"
- "instagram"
- "youtube"
- "facebook"
uuid1 <= value <= 100Value in
- "recent"
- "top"
Start of the period, inclusive. Use an ISO 8601 timestamp with a timezone offset, and URL-encode + as %2B. Defaults to 90 days before until.
date-timeEnd of the period, exclusive. Use the same format as since. Defaults to now. The period from since to until can be at most 90 days.
date-timeNumber of matching posts to skip. To get the next page, add the number of returned posts to the previous offset. Keep since, until, sort, and the filters the same.
0 <= value <= 99000Response body
application/json
application/json