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"{ "posts": [ { "postId": "18000000000000001", "platform": "threads", "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, "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 locally synchronized data 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.
Authorization
apiKey In: header
Query Parameters
Value in
- "threads"
- "x"
- "linkedin"
- "tiktok"
- "instagram"
- "youtube"
- "facebook"
uuid1 <= value <= 100Value in
- "recent"
- "top"
Response Body
application/json