Rednote Comment Replies
Rednote 댓글 답글은 노트의 특정 댓글 아래에 중첩된 공개 응답으로, 답글 텍스트, 작성자 정보, 타임스탬프, 확인 가능한 관계·참여 필드를 담고 있습니다. 정규화된 레코드를 활용하면 원본 댓글 식별자와 저장된 결과의 페이지네이션을 섞지 않고 알고 있는 대화 가지 하나를 살펴볼 수 있습니다.
Rednote Comment Replies API 주요 기능
- 짝을 이루는 스레드 참조공개 노트 URL과 그 노트에 속한 댓글 식별자를 함께 지정해 대화 가지를 정확히 가리킵니다.
- 단일 페이지 답글 수집원본 요청을 한 번 실행해 그 페이지에 반환된 답글을 저장하며, 제공처 커서나 제출 시 결과 수 제한은 노출하지 않습니다.
- 정규화된 답글 본문답글 ID, 공개 텍스트, 원본 URL, 게시 시각, 수집 시각을 공통 CommentItem 형태로 읽습니다.
- 공개 작성자 정보확인 가능한 작성자 ID, 사용자 이름, 표시 이름, 프로필 URL, 아바타, 계정 플래그를 답글마다 함께 보관합니다.
- 대화 관계스레드를 고려한 처리를 위해 확인 가능한 parent_id, post_id 링크를 공개된 좋아요 수·답글 수와 함께 유지합니다.
Rednote Comment Replies API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 호스트가 xiaohongshu.com, xhslink.com 또는 둘 중 하나의 서브도메인인 공개 URL로, 필수 값입니다. 이 엔드포인트는 경로 패턴이나 xsec_token 쿼리 규칙을 추가로 요구하지 않습니다. |
comment_id | 필수 | 원본 댓글의 식별자로, 필수 값입니다. 길이 1~256자의 ASCII 문자, 숫자, 콜론, 밑줄, 하이픈을 사용할 수 있습니다. |
Rednote Comment Replies API 사용 방법
서로 일치하는 Rednote 노트 URL과 댓글 ID를 제출하고, SocQ의 비동기 작업 워크플로로 한 페이지 분량의 답글 결과를 읽습니다.
- 공개 xiaohongshu.com 또는 xhslink.com 노트 URL을 고르고, 같은 노트에 속한 사용할 수 있는 댓글 ID를 확인합니다.
- url과 comment_id를 /v1/rednote/comment-replies로 POST하고, 반환된 task_id를 보관합니다.
- 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링하고, succeeded 또는 failed가 되면 중단합니다.
- 성공하면 data.results.items를 읽습니다. data.results.next_cursor는 SocQ에 이미 저장된 답글 행을 넘겨 볼 때만 사용합니다.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededRednote Comment Replies API 추천 활용 사례
- 특정 대화 집중 검토: 노트 전체의 답글을 뒤섞지 않고, 선택한 댓글 가지 하나의 공개 답글 텍스트와 타임스탬프를 읽습니다.
- 참여자 정보 보강: 모더레이션 리서치나 수동 검토용 레코드를 준비할 때 각 답글에 확인 가능한 정규화된 작성자 정보를 연결합니다.
- 스레드 관계 매핑: 답글 ID를 parent_id, post_id와 함께 사용해, 해당 필드가 있는 경우 저장된 레코드를 원본 댓글과 노트에 다시 연결합니다.
- 시점별 반응 스냅샷: 공개된 좋아요 수·답글 수 옆에 collected_at을 보존해, 별도로 실행한 결과를 서로 다른 관측값으로 구분합니다.
Rednote Comment Replies API 활용 팁
- comment_id가 제출한 노트 URL에 속하는지 직접 확인하세요. 엔드포인트는 필드별 형식만 검증하며, 원본 요청 전에 둘의 관계를 확인하지는 않습니다.
- 이 검증기는 특정 노트 경로나 xsec_token 쿼리 매개변수를 요구하지 않지만, xiaohongshu.com, xhslink.com 또는 허용되는 서브도메인의 완전한 공개 URL을 사용하세요.
- comment_id는 허용되는 1~256자 ASCII 식별자 패턴을 지키고, 내부 데이터베이스 ID나 SocQ 작업 ID로 대체하지 마세요.
- 다른 수집에서 가져온 댓글 ID는 조건부 입력으로 다루세요. 정규화된 댓글 ID는 선택 값이므로, 여기에 제출하기 전에 사용할 수 있는 값이 있는지 확인하세요.
- 제출 페이로드에 results_limit이나 원본 커서를 추가하지 마세요. 이 엔드포인트는 원본 페이지 하나에 대해 제공처 요청을 한 번만 보냅니다.
- 작업 결과의 next_cursor는 comment_id와 별개로 다루세요. 이 커서는 작업이 성공한 뒤 저장된 정규화 행을 넘겨 보는 용도로만 쓰입니다.
- 신원, 관계, 타임스탬프, 지표 필드가 null일 수 있다고 가정하고, 공개 답글 텍스트는 다른 제품에 표시하기 전에 이스케이프 처리하세요.
관련 API
Rednote Comment Replies API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.