List comments
Read synchronized comments with inbox statuses and filters.
curl -X GET "https://example.com/api/v1/comments?platform=instagram&accountId=11111111-1111-4111-8111-111111111111&status=unanswered&days=7&cursor=eyJ2IjoxfQ"{ "comments": [ { "commentId": "18000000000000101", "platform": "instagram", "accountId": "11111111-1111-4111-8111-111111111111", "accountUsername": "your_brand", "postId": "18000000000000001", "postText": "Our new collection is here", "parentCommentId": null, "author": "happy_customer", "text": "Is this available in blue?", "createdAt": "2026-11-06T10:00:00Z", "permalink": "https://www.instagram.com/p/example/", "fromAccount": false, "hidden": false, "status": "replied" }, { "commentId": "18000000000000102", "platform": "instagram", "accountId": "11111111-1111-4111-8111-111111111111", "accountUsername": "your_brand", "postId": "18000000000000001", "postText": "Our new collection is here", "parentCommentId": "18000000000000101", "author": "your_brand", "text": "Yes! It's in stock now.", "createdAt": "2026-11-06T11:00:00Z", "permalink": null, "fromAccount": true, "hidden": false, "status": null } ], "days": 30, "hasMore": false, "nextCursor": null}List comments on the API key's workspace posts, with the same filters and statuses as the Posteady comment inbox. This request reads comments already synchronized to Posteady and does not refresh the platforms. status is unanswered, replied (the latest reply in the thread is from the account), or resolved (marked as handled in Posteady); comments the account wrote have no status. Each comment links to its post with postId and to its parent comment with parentCommentId. While hasMore is true, send nextCursor as cursor with the same filters. If some platforms can't be read, failedPlatforms lists them and nextCursor is withheld so their comments aren't skipped; retry the same request later.
Authorization
apiKey In: header
Query parameters
Value in
- "threads"
- "instagram"
- "x"
- "youtube"
- "tiktok"
- "linkedin"
- "facebook"
uuid"all"Value in
- "all"
- "unanswered"
- "replied"
- "resolved"
Period in days. 0 reads all synchronized comments.
30Value in
- 7
- 30
- 90
- 0
nextCursor from the previous response. Send it with the same filters.
Response body
application/json
application/json