rednote/
note-comments

xiaohongshu.com 또는 xhslink.com 노트 URL에서 공개 Rednote 댓글을 한 페이지 분량 수집하고, 텍스트, 작성자, 타임스탬프, 노트 참조, 공개된 참여 지표를 반환합니다.

Rednote Note Comments API

노트 URL 입력
원본 요청 1회
정규화된 댓글
요청당 1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 노트 링크 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 댓글을 읽습니다.

  1. xiaohongshu.com 또는 xhslink.com의 실제 Rednote 노트 공유 링크를 복사합니다.
  2. url을 /v1/rednote/note-comments로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Rednote 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는 완료된 작업에 이미 저장된 정규화 레코드만 페이지로 넘겨 볼 뿐입니다.

Rednote Note Comments API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Rednote 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Rednote Note Comments API — 자주 묻는 질문

Rednote Note Comments API는 지정한 Rednote 노트 링크에 달린 공개 댓글을 원본 응답 한 페이지 분량 수집합니다.

런타임은 파싱된 호스트 이름이 xiaohongshu.com, xhslink.com 또는 그 서브도메인인, 비어 있지 않은 url 하나를 요구합니다. 특정 경로나 쿼리는 강제하지 않지만, 제공처가 제대로 찾으려면 실제 노트 공유 링크가 필요합니다.

아니요. rednote/note-comments는 공통 Rednote 호스트 이름 검증기만 적용합니다. 더 엄격한 경로와 xsec_token 검사는 별도의 note-detail 사양에 적용됩니다.

아니요. 제출 사양은 url만 받으며, 제공처 연동은 호출자가 원본 페이지네이션을 제어하지 못하는 원본 요청을 한 번만 보냅니다.

공통 작업 결과 리더는 성공한 작업에 이미 저장된 CommentItem 레코드를 페이지 단위로 읽을 수 있습니다. 이 불투명한 SocQ 커서는 Rednote 원본의 다른 페이지를 요청하지 않습니다.

성공한 Rednote Note Comments 작업 1건마다 고정으로 1.00 SocQ 크레딧이 차감되며, 원본 요청 한 번에서 반환된 댓글 수와는 관계가 없습니다.