Posteady
Posteady Docs
User guideDeveloper guidesAPI referenceMCP

List comments

Read synchronized comments with inbox statuses and filters.

GET
/api/v1/comments
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.

AuthorizationBearer <token>

In: header

Query parameters

platform?string

Value in

  • "threads"
  • "instagram"
  • "x"
  • "youtube"
  • "tiktok"
  • "linkedin"
  • "facebook"
accountId?string
Formatuuid
status?string
Default"all"

Value in

  • "all"
  • "unanswered"
  • "replied"
  • "resolved"
days?integer

Period in days. 0 reads all synchronized comments.

Default30

Value in

  • 7
  • 30
  • 90
  • 0
cursor?string

nextCursor from the previous response. Send it with the same filters.

Response body

application/json

application/json