rednote/
user-profile

지원되는 계정 URL 또는 user_id로 공개 Rednote 프로필 하나를 조회하고, 정규화된 계정 정보, 프로필 이미지, 계정 플래그, 공개된 수치, 수집 시각을 반환합니다.

Rednote User Profile API

URL 또는 user_id
정규화된 계정 1건
고정 1크레딧 작업
요청당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

지원되는 계정 참조 하나를 제출하고, 비동기 작업을 추적한 뒤, 저장된 결과 페이지에서 정규화된 계정을 읽습니다.

  1. 유효한 공개 user_id, 또는 파싱된 호스트 이름이 xiaohongshu.com, xhslink.com 또는 둘 중 하나의 서브도메인인 URL을 준비합니다.
  2. user_id, url 또는 둘 다를 /v1/rednote/user-profile로 제출합니다. 둘 다 있으면 user_id가 우선합니다. 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Rednote 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과 구분해서 관리하세요.

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

다른 플랫폼 둘러보기

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

Rednote User Profile API — 자주 묻는 질문

Rednote User Profile API는 지원되는 계정 URL 또는 user_id에서 공개 Rednote 프로필을 최대 1건 조회해 정규화된 계정 레코드를 반환합니다.

알고 있다면 user_id를 사용하세요. 두 필드를 모두 제출해도 되지만 명시한 user_id가 우선하며, URL은 원본 조회에 전달되지 않습니다.

URL은 파싱 결과가 xiaohongshu.com, xhslink.com 또는 서브도메인이어야 합니다. user_id는 길이 1~256자의 ASCII 문자, 숫자, 콜론, 밑줄, 하이픈으로 이루어져야 합니다.

결과에는 ID, 원본 URL, Rednote 핸들, 표시 이름, 소개, 아바타, 커버 이미지, 웹사이트, 인증·비공개 플래그, 팔로워·팔로잉·게시물 수, 수집 시각이 포함될 수 있습니다. 개별 필드는 null일 수 있습니다.

아니요. user_id는 조회에 쓰는 식별자이고, 정식 결과에는 별도의 id가 있습니다. username에는 원본이 제공하는 경우 Rednote 핸들이 담기므로, 원본 값을 확인하지 않고 user_id 대신 사용해서는 안 됩니다.

아니요. 작업 하나는 프로필 상세 요청을 한 번만 보내며 계정을 최대 1건 저장합니다. 공통 작업 결과 응답에는 SocQ에 저장된 레코드를 읽기 위한 items, next_cursor, has_more가 그대로 포함됩니다.

성공한 Rednote User Profile 작업 1건마다 고정으로 1.00 SocQ 크레딧이 차감됩니다. 필드 수나 저장된 결과 수에 따라 요금이 달라지지 않습니다.