API 레퍼런스댓글
댓글 조회
동기화된 댓글을 인박스 상태와 필터로 확인합니다.
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}API 키의 워크스페이스 게시물에 달린 댓글을 Posteady 댓글 인박스와 같은 필터·상태로 조회합니다. 이 요청은 Posteady에 이미 동기화된 댓글을 읽으며 플랫폼을 새로 고치지 않습니다. status는 unanswered(미답변), replied(스레드의 마지막 답글이 계정 것), resolved(Posteady에서 처리 완료로 표시)이며 계정이 단 댓글에는 상태가 없습니다. 각 댓글은 postId로 게시물에, parentCommentId로 부모 댓글에 연결됩니다. hasMore가 true이면 nextCursor를 같은 필터와 함께 cursor로 보내세요. 일부 플랫폼을 읽지 못하면 failedPlatforms에 담고, 그 플랫폼 댓글을 건너뛰지 않도록 nextCursor를 주지 않습니다. 잠시 뒤 같은 요청을 다시 보내세요.
인증
apiKey 인증Bearer <token>
위치: header
쿼리 매개변수
platform?string
허용값
- "threads"
- "instagram"
- "x"
- "youtube"
- "tiktok"
- "linkedin"
- "facebook"
accountId?string
형식
uuidstatus?string
기본값
"all"허용값
- "all"
- "unanswered"
- "replied"
- "resolved"
days?integer
기간(일)입니다. 0이면 동기화된 모든 댓글을 읽습니다.
기본값
30허용값
- 7
- 30
- 90
- 0
cursor?string
이전 응답의 nextCursor입니다. 같은 필터와 함께 보내세요.
응답 본문
application/json
application/json