Posteady
Posteady Docs
사용 가이드개발자 가이드API 레퍼런스MCP
개발자 가이드작업별 가이드

댓글 조회와 답글

답할 댓글을 찾아 답글을 달고, 댓글을 숨기거나 지우세요.

답할 댓글 찾기

curl --get "https://www.posteady.com/api/v1/comments" \
  --data "status=unanswered" --data "days=7" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"
인자의미
platformthreads·instagram·x·youtube·tiktok·linkedin·facebook, 생략 시 전체
accountId계정 UUID로 필터
statusall(기본)·unanswered·replied·resolved
days7·30(기본)·90, 0이면 동기화된 모든 댓글
cursor이전 응답의 nextCursor

필터와 상태는 Posteady 댓글 인박스와 같습니다. replied는 그 댓글 아래 마지막 답글이 계정 것이라는 뜻입니다. resolved는 Posteady에서 처리 완료로 표시한 댓글입니다. 그 밖의 다른 사람 댓글은 unanswered입니다. 계정이 단 댓글은 fromAccount: true이고 상태가 없습니다.

답글에는 각 댓글의 commentId·accountId·platform을 씁니다. postId는 게시물의 플랫폼 ID이고, parentCommentId는 이 댓글이 답한 댓글입니다.

이 API는 Posteady에 이미 동기화된 댓글을 읽습니다. 호출할 때 플랫폼에서 새 댓글을 가져오지 않습니다.

hasMore가 true이면 nextCursor를 같은 필터와 함께 cursor로 보내세요. failedPlatforms가 있으면 그 플랫폼의 댓글을 읽지 못한 것입니다. 이때는 그 플랫폼 댓글을 건너뛰지 않도록 nextCursor가 null입니다. 잠시 뒤 같은 요청을 다시 보내세요.

댓글에 답글 달기

목록의 commentId·platform·accountId를 보내세요. LinkedIn은 같은 commentId가 여러 게시물에 있을 수 있으므로 postId도 함께 보내세요.

curl --request POST "https://www.posteady.com/api/v1/comments/18000000000000101/replies" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "platform": "instagram",
  "accountId": "11111111-1111-4111-8111-111111111111",
  "text": "네, 지금 재고가 있어요."
}'

답글은 댓글을 받은 계정 이름으로 달립니다. 텍스트만 됩니다. 응답에는 새 답글의 replyId와 답글이 실제로 달린 parentCommentId가 있습니다. Posteady는 단 답글을 댓글 목록에도 바로 넣으므로, 다음 동기화 전에도 그 스레드가 replied로 보입니다.

플랫폼답글 규칙
Instagram·YouTube·Facebook답글은 한 단계까지만 둡니다. 답글에 단 답글은 스레드의 최상위 댓글에 달리고 note로 알려 줍니다
Facebook페이지 이름으로 답글을 답니다. 연결한 계정에 댓글 관리 권한과, 댓글을 관리할 수 있는 페이지 역할이 있어야 합니다
TikTokTikTok for Business로 연결한 계정이어야 합니다. TikTok이 새 답글 ID를 주지 않으면 replyId가 null이고, 답글은 다음 동기화 뒤 목록에 나타납니다
X한글·중국어·일본어 글자와 이모지는 2자로 셉니다. Posteady가 답글을 목록에 저장하지 못하면 note로 알려 줍니다
LinkedIn댓글 목록의 postId를 함께 보내세요
플랫폼본문 최대 길이
Instagram2,200자
YouTube10,000자
Threads500자
X280자
LinkedIn1,250자
Facebook8,000자
TikTokTikTok이 정한 한도

결과와 오류

답글 요청에는 requestId가 없습니다. 같은 요청을 다시 보내면 답글이 두 번 달릴 수 있으니, 결과를 확인한 뒤 다시 보내세요.

응답다음 할 일
422 VALIDATION_ERROR메시지를 읽으세요. 본문이 너무 길거나, X가 같은 내용을 거절했거나, LinkedIn 답글에 postId가 필요할 수 있습니다
403 INSUFFICIENT_PERMISSION워크스페이스 권한을 확인하세요. Facebook은 그 페이지에서 계정의 역할도 확인하세요
404 COMMENT_NOT_FOUND댓글 목록의 ID를 쓰세요. 댓글이 삭제되었을 수 있습니다
409 ACCOUNT_TOKEN_EXPIREDPosteady에서 계정을 다시 연결하세요
429 RATE_LIMITED플랫폼 요청 한도에 걸렸습니다. 기다렸다가 다시 보내세요
502 PLATFORM_ERROR답글이 이미 달렸을 수 있습니다. 다시 보내기 전에 플랫폼에서 그 댓글을 확인하세요
503 SERVICE_UNAVAILABLE아무것도 달리지 않았습니다. 잠시 뒤 다시 보내세요

요청 시간이 초과되면 다시 보내기 전에 플랫폼에서 그 댓글을 확인하세요. 댓글을 읽으려면 API 키를 만든 멤버에게 '댓글 조회' 권한이, 답글을 달려면 '댓글 작성' 권한이 있어야 합니다.

댓글 숨기기와 삭제

curl --request PATCH "https://www.posteady.com/api/v1/comments/18000000000000101" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "platform": "instagram",
  "accountId": "11111111-1111-4111-8111-111111111111",
  "hidden": true
}'

다시 보이게 하려면 "hidden": false를 보내세요. 댓글을 지우려면 같은 값을 쿼리 인자로 보냅니다.

curl --request DELETE "https://www.posteady.com/api/v1/comments/18000000000000101?platform=instagram&accountId=11111111-1111-4111-8111-111111111111" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

규칙은 Posteady 댓글 인박스와 같습니다. LinkedIn은 postId도 함께 보내세요.

작업규칙
숨기기·다시 보이기다른 사람이 단 댓글만 됩니다. LinkedIn은 숨기기를 지원하지 않습니다. YouTube는 최상위 댓글만 숨길 수 있고, 숨기면 검토 보류가 됩니다. X는 계정이 시작한 대화의 답글만 숨길 수 있습니다
삭제우리 계정이 단 댓글(fromAccount: true)은 모든 플랫폼에서, 그 댓글을 쓴 계정으로 지웁니다. 다른 사람이 단 댓글은 Instagram·Facebook에서만 지울 수 있고, 다른 플랫폼에서는 숨기세요. Instagram·Facebook·LinkedIn은 그 댓글의 답글도 함께 지웁니다

삭제는 되돌릴 수 없습니다. 숨기거나 지울 수 없는 댓글이면 이유와 함께 422 VALIDATION_ERROR를 돌려줍니다. Posteady는 댓글 목록도 바로 고치고, 고치지 못하면 note로 알려 줍니다. 숨기려면 '댓글 편집' 권한이, 지우려면 '댓글 삭제' 권한이 있어야 합니다.

댓글 조회 레퍼런스 · 답글 레퍼런스 · 숨기기 레퍼런스 · 삭제 레퍼런스 · 오류 가이드

이 페이지에서