Rednote Note Comments
Rednote 노트 댓글은 특정 노트에 달린 공개 응답으로, 댓글 텍스트, 작성자 정보, 게시 시각, 스레드 참조, 공개된 상호작용 수를 담을 수 있습니다. 선택한 노트를 둘러싼 사람들의 반응을 보존하면서, 각 관측값을 원본과 수집 시각에 연결해 둘 수 있습니다.
Rednote Note Comments API 주요 기능
- 유연한 Rednote 공유 링크 입력xiaohongshu.com, xhslink.com 또는 그 서브도메인에 있는 참조 하나를 제출합니다. 노트 댓글 검증기는 특정 경로, 쿼리 문자열, xsec_token을 요구하지 않습니다.
- 안정적인 댓글 레코드댓글 ID, 텍스트, 원본 URL, 타임스탬프, 확인 가능한 작성자 정보를 정규화된 CommentItem 1.0 결과 형태로 받습니다.
- 노트·스레드 참조값이 제공되면 post_id와 parent_id를 유지해, 반환된 댓글을 해당 노트 및 확인 가능한 부모 맥락과 연결된 상태로 둘 수 있습니다.
- 시점별 참여 지표 필드확인 가능한 likes_count와 replies_count를 collected_at 옆에 유지하며, 없는 값을 0으로 바꾸거나 모든 답글이 수집되었다고 암시하지 않습니다.
Rednote Note Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 비어 있지 않은 참조로, 필수 값입니다. 런타임 검증은 xiaohongshu.com, xhslink.com과 그 서브도메인을 경로 강제나 xsec_token 요구 없이 허용합니다. 제공처가 의도한 노트를 찾을 수 있도록 실제 노트 공유 링크를 사용하세요. |
Rednote Note Comments API 사용 방법
지원되는 Rednote 노트 링크 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 댓글을 읽습니다.
- xiaohongshu.com 또는 xhslink.com의 실제 Rednote 노트 공유 링크를 복사합니다.
- url을 /v1/rednote/note-comments로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. 저장된 작업 결과를 넘겨 볼 때만, has_more가 true인 동안 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://xhslink.com/{share_code}"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueRednote Note Comments API 추천 활용 사례
- 정성적 반응 코딩: 반환된 공개 텍스트와 확인 가능한 작성자 정보를 검토해, 선택한 노트 하나를 둘러싼 질문, 반응, 반복되는 토론 주제를 정리합니다.
- 출처가 연결된 댓글 아카이브: 댓글 ID, 원본 URL, post_id, parent_id, published_at, collected_at을 보존해 추적 가능한 리서치 기록을 만듭니다.
- 참여 지표 스냅샷 검토: 반환된 댓글 사이에서 확인 가능한 좋아요 수와 답글 수를 비교하되, 모든 관측값을 수집 시각에 맞춰 기록합니다.
Rednote Note Comments API 활용 팁
- 의도한 노트에서 복사한 전체 공유 링크를 사용하세요. 호스트 이름 검증을 통과했다고 해서 관련 없는 경로까지 제공처가 찾아 준다는 보장은 없습니다.
- xsec_token을 임의로 만들거나 따로 요구하지 마세요. 이 규칙은 rednote/note-comments가 아니라 note-detail 사양에 해당합니다.
- results_limit이나 제공처 커서는 보내지 마세요. 제출 값은 url뿐이며 원본 요청은 한 번만 보냅니다.
- parent_id, post_id, 타임스탬프, 작성자 속성, 지표는 반드시 있는 값이 아니라 null일 수 있는 원본 필드로 다루세요.
- 원본 수집 범위와 next_cursor를 구분하세요. next_cursor는 완료된 작업에 이미 저장된 정규화 레코드만 페이지로 넘겨 볼 뿐입니다.
관련 API
Rednote Note Comments API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.