Rednote User Profile
공개 Rednote 프로필은 계정 식별자, Rednote 핸들, 표시 이름, 소개, 프로필 이미지, 웹사이트, 계정 플래그, 공개된 팔로워·팔로잉·게시물 수를 보여 줄 수 있습니다. 정규화된 레코드는 확인 가능한 식별 필드와 특정 시점의 지표를 한데 묶어, 계정 매칭, 선택한 프로필 비교, 반복 스냅샷 분석에 쓸 수 있게 합니다.
Rednote User Profile API 주요 기능
- 우선순위가 명확한 두 가지 조회 방식지원되는 Rednote URL 또는 공개 user_id로 프로필 하나를 조회합니다. 두 필드를 모두 보내면 명시한 user_id로 원본 조회를 수행합니다.
- 일관된 공개 식별 정보 레코드확인 가능한 계정 ID, 원본 URL, Rednote 핸들, 표시 이름, 소개, 아바타, 커버 이미지, 웹사이트, 인증 플래그, 비공개 플래그를 정규화합니다.
- 시각이 기록된 공개 계정 지표확인 가능한 팔로워·팔로잉·게시물 수를 collected_at과 함께 반환하므로, 각 결과는 실시간 합계가 아니라 특정 시점의 관측값으로 유지됩니다.
Rednote User Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수(하나 이상) | url 또는 user_id 중 하나는 필수입니다. 파싱된 호스트 이름은 xiaohongshu.com, xhslink.com 또는 둘 중 하나의 서브도메인이어야 합니다. user_id도 함께 있으면 user_id가 우선합니다. |
user_id | 필수(하나 이상) | user_id 또는 url 중 하나는 필수입니다. 길이 1~256자의 ASCII 문자, 숫자, 콜론, 밑줄, 하이픈을 사용합니다. url도 함께 보내면 이 명시적 식별자가 우선합니다. |
Rednote User Profile API 사용 방법
지원되는 계정 참조 하나를 제출하고, 비동기 작업을 추적한 뒤, 저장된 결과 페이지에서 정규화된 계정을 읽습니다.
- 유효한 공개 user_id, 또는 파싱된 호스트 이름이 xiaohongshu.com, xhslink.com 또는 둘 중 하나의 서브도메인인 URL을 준비합니다.
- user_id, url 또는 둘 다를 /v1/rednote/user-profile로 제출합니다. 둘 다 있으면 user_id가 우선합니다. 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items에서 계정을 읽습니다. 저장된 결과 리더가 has_more를 true로 보고할 때만 next_cursor를 사용합니다.
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueRednote User Profile API 추천 활용 사례
- 알고 있는 계정 정보 보강: 이미 가지고 있는 공개 Rednote 계정 참조를, 확인 가능한 프로필 텍스트, 이미지, 웹사이트, 계정 플래그가 담긴 일관된 식별 정보 레코드로 바꿉니다.
- 프로필 스냅샷 비교: 안정적인 결과 ID, collected_at, 수집 시점의 팔로워·팔로잉·게시물 수를 활용해 선택한 계정끼리 또는 반복 수집한 결과끼리 비교합니다.
Rednote User Profile API 활용 팁
- 입력은 하나 이상 제공하세요. url과 user_id가 모두 있으면 백엔드는 명시한 user_id를 사용하며 URL은 원본 조회에 전달하지 않습니다.
- 공개 계정 식별자를 이미 알고 있다면 user_id를 우선 사용하세요. 공유 URL이나 계정 URL의 구조에 의존하지 않아도 됩니다.
- 제출 전에 user_id는 ^[A-Za-z0-9:_-]{1,256}$ 패턴으로 검증하고, 파싱된 URL의 호스트 이름이 xiaohongshu.com, xhslink.com 또는 서브도메인과 일치하는지 확인하세요.
- results_limit이나 원본 커서는 추가하지 마세요. 이 엔드포인트는 상세 요청을 한 번만 보내며, next_cursor는 SocQ의 저장된 결과 리더에만 해당합니다.
- 소개, 프로필 이미지, 웹사이트, 플래그, 모든 지표는 선택 값으로 다루세요. 없는 필드를 빈 문자열이나 0으로 바꾸지 말고 null 그대로 보존하세요.
- 이전 Rednote 계정 결과의 정식 id를 user_id로 사용할 수 있습니다. 이 식별자는 Rednote 핸들을 나타내는, 반환된 username과 구분해서 관리하세요.
관련 API
Rednote User Profile API 외에 Rednote의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.