Rednote User Notes
Rednote 사용자 노트는 계정이 게시한 공개 콘텐츠로, 텍스트, 작성자 표기, 미디어, 게시 시각, 공개된 참여 지표를 담고 있습니다. 이러한 콘텐츠와 맥락 필드는 계정 리서치, 게시 패턴 검토, 형식 비교, 시점별 성과 분석에 활용할 수 있습니다.
Rednote User Notes API 주요 기능
- 우선순위가 정해진 두 가지 계정 식별 입력지원되는 Rednote 사용자 참조 또는 user_id 중 하나를 받으며, 두 필드를 모두 보내면 명시한 user_id를 사용합니다.
- 1페이지 단위 계정 노트 수집선택한 계정에 대해 원본 요청 한 번으로 반환되는 공개 노트를 가져오며, 원본 커서나 호출자가 지정하는 결과 수 제한은 노출하지 않습니다.
- 정규화된 노트와 작성자 정보노트 ID, 공개 URL, 텍스트, 작성자 식별 정보, 미디어 참조, 게시 시각, 수집 시각을 일관된 PostItem 구조로 반환합니다.
- 공개된 참여 지표 스냅샷확인 가능한 좋아요·댓글·공유·조회 수를 collected_at과 함께 보존해 기간별 비교에 쓸 수 있게 합니다.
Rednote User Notes API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수(하나 이상) | 파싱된 호스트 이름이 xiaohongshu.com, xhslink.com 또는 둘 중 하나의 서브도메인인, 비어 있지 않은 Rednote 사용자 참조입니다. 경로 패턴은 요구하지 않으며, URL에 /user/<identifier>가 포함되고 user_id가 비어 있으면 그 식별자를 사용하고, 그렇지 않으면 허용된 URL이 계정 참조로 유지됩니다. |
user_id | 필수(하나 이상) | 길이 1~256자의 ASCII 문자, 숫자, 콜론, 밑줄, 하이픈으로 이루어진 Rednote 사용자 식별자입니다. url 또는 user_id 중 하나를 제공하세요. 둘 다 있으면 명시한 user_id가 우선합니다. |
Rednote User Notes API 사용 방법
지원되는 Rednote 계정 식별 정보 하나를 제출하고, 비동기 작업을 추적한 뒤, 저장된 정규화 노트 레코드를 페이지 단위로 읽습니다.
- 허용되는 호스트의 비어 있지 않은 Rednote 사용자 URL 또는 유효한 user_id 중 하나를 준비하고, 필요하지 않은 다른 필드는 비워 둡니다.
- url 또는 user_id를 /v1/rednote/user-notes로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고 has_more가 true인 동안 next_cursor를 따라갑니다. 이 커서는 저장된 레코드를 넘겨 보는 것이며, Rednote 원본의 추가 페이지를 가져오지는 않습니다.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_USER_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueRednote User Notes API 추천 활용 사례
- 공개 계정 게시물 목록화: 노트 ID, 공개 URL, 텍스트, 작성자 표기, 게시 시각을 활용해 반환된 계정 스냅샷을 카탈로그로 정리합니다.
- 콘텐츠 형식 검토: 계정에서 반환된 노트들의 이미지·동영상 참조, 크기, 썸네일, 노트 텍스트를 비교합니다.
- 게시 패턴 분석: 노트를 published_at 순으로 정렬하고 텍스트와 미디어를 함께 살펴, 스냅샷 안에서 확인되는 계정의 게시 구성을 검토합니다.
- 시점별 참여 지표 비교: 공개된 좋아요, 댓글, 공유, 조회 수를 비교하되, collected_at으로 각 관측값을 수집 시각에 묶어 둡니다.
Rednote User Notes API 활용 팁
- 안정적인 user_id가 이미 있다면 그것을 사용하세요. url보다 우선하므로 두 계정 참조 사이의 모호함이 생기지 않습니다.
- url을 제출할 때는 호스트 이름이 xiaohongshu.com 또는 xhslink.com인지 확인하세요. 특정 경로 패턴은 요구하지 않습니다.
- 지원되는 URL에 /user/<identifier>가 포함되어 있다면, user_id가 비어 있을 때 그 식별자를 사용하므로 경로가 의도한 계정을 가리키는지 확인하세요.
- 제출 값에 results_limit이나 원본 커서를 추가하지 마세요. 작업마다 한 페이지에 대한 원본 요청을 한 번만 보냅니다.
- cursor와 limit은 작업이 완료된 뒤 GET /v1/tasks/{task_id}에서만 사용하세요. 저장된 결과에 대해 limit의 기본값은 50이며 1에서 500까지 지정할 수 있습니다.
- 텍스트, 작성자 필드, 미디어, 게시 시각, 해시태그, 멘션, 개별 지표가 null일 수 있다고 가정하고, 공개 텍스트는 표시하기 전에 이스케이프 처리하세요.
관련 API
Rednote User Notes API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.