Rednote Note Detail
Rednote 노트는 텍스트와 미디어에 작성자 정보, 주제 참조, 게시 시각, 공개된 참여 지표가 함께 담긴 공개 콘텐츠 객체입니다. 이러한 필드는 알고 있는 링크의 정보 보강, 콘텐츠 검토, 선택한 노트의 시점별 비교에 활용할 수 있습니다.
Rednote Note Detail API 주요 기능
- 토큰이 확인된 노트 조회허용되는 호스트, 노트 상세 경로, 비어 있지 않은 xsec_token이 완전한 원본 조회를 식별할 때에 한해, 알고 있는 공개 노트 URL 하나를 조회합니다.
- 노트와 작성자 정보정규화된 노트 식별 정보, 원본 URL, 텍스트, 타임스탬프와 함께 확인 가능한 작성자 ID, 사용자 이름, 표시 이름, 프로필 URL, 아바타, 계정 플래그를 반환합니다.
- 미디어와 참여 지표 스냅샷확인 가능한 미디어 참조, 미리보기, 크기, 길이, 주제 참조, 공개된 좋아요·댓글·공유·조회 수를 수집 시각과 함께 보관합니다.
Rednote Note Detail API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | xiaohongshu.com, xhslink.com 또는 그 서브도메인의 비어 있지 않은 URL로, 필수 값입니다. 경로에 /explore/{note_id} 또는 /discovery/item/{note_id}가 포함되어야 하며, 쿼리에 비어 있지 않은 xsec_token이 있어야 합니다. |
Rednote Note Detail API 사용 방법
유효한 토큰이 포함된 노트 URL을 준비해 비동기 요청을 제출하고, 완료 후 정규화된 게시물 레코드 하나를 읽습니다.
- 허용되는 호스트, 노트 상세 경로, 비어 있지 않은 xsec_token이 쿼리 문자열에 포함된 최신 공개 노트 URL을 복사합니다.
- url을 /v1/rednote/note-detail로 POST하고, 제출 응답의 data.task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공 후 data.results.items를 읽습니다. 원본 조회는 상세 요청 한 번이며, next_cursor는 SocQ에 저장된 레코드만 페이지로 넘겨 봅니다.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes
curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsRednote Note Detail API 추천 활용 사례
- 알고 있는 노트 카탈로그 보강: 조건을 갖춘 노트 URL을 기존 콘텐츠 인덱스에 쓸 정규화된 식별 정보, 텍스트, 작성자, 게시 시각, 원본 필드로 바꿉니다.
- 선택한 노트 콘텐츠 검토: 텍스트, 작성자 정보, 미디어 참조, 주제 필드를 활용해 정해 둔 개별 공개 노트들을 살펴봅니다.
- 참여 지표 관측값 비교: 공개된 좋아요·댓글·공유·조회 수를 collected_at과 짝지어, 따로 제출한 조회 결과들을 시점별로 비교합니다.
Rednote Note Detail API 활용 팁
- 호스트, /explore/ 또는 /discovery/item/ 경로, xsec_token 쿼리 매개변수를 모두 포함한 전체 노트 URL을 사용하세요. 노트 ID만으로는 검증을 통과할 수 없습니다.
- 요청은 url만 받고 별도의 토큰 필드는 거부하므로, xsec_token은 URL 쿼리 안에 그대로 두세요.
- 다른 SocQ Rednote 노트 결과의 URL을 재사용할 때는 xsec_token이 아직 남아 있는지 확인하세요. Note Detail은 빠진 토큰을 복원할 수 없습니다.
- 이 상세 엔드포인트에는 일괄 처리 필드, results_limit, 원본 커서 입력이 없으므로 작업 하나에 URL 하나만 제출하세요.
- next_cursor는 저장된 결과의 페이지네이션으로만 취급하세요. 원본은 상세 조회를 한 번만 수행하며 일반적으로 레코드를 최대 1건 만듭니다.
- 선택적인 공개 값이 없을 수 있으므로 작성자, 미디어, 주제, 타임스탬프, 참여 지표 필드는 방어적으로 저장하고, 공개된 카운터는 collected_at과 함께 보관하세요.
관련 API
Rednote Note Detail API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.