Rednote 공개 데이터 API
공개 프로필과 노트를 가져오고, 노트나 사용자를 검색하고, 댓글과 중첩 답글을 수집하고, 홈 추천 페이지 하나를 가져옵니다.
사용할 수 있는 Rednote API
프로필, 노트, 댓글, 답글, 검색, 추천 워크플로를 위한 8종의 API 중에서 고르세요.
어떤 Rednote 데이터를 가져올 수 있나요?
Rednote 카탈로그는 공개 원본 데이터에서 정규화된 계정, 게시물, 댓글 레코드를 반환합니다.
프로필과 사용자 노트
지원하는 계정 URL이나 user_id로 공개 프로필 하나를 확인하거나 노트의 원본 한 페이지를 수집합니다.
노트 상세와 탐색
토큰이 포함된 노트 URL 하나를 가져오고, 지원하는 필터로 노트를 검색하거나, 홈 추천 페이지 하나를 수집합니다.
사용자 검색
비어 있지 않은 검색어 하나로 공개 계정의 고정된 첫 번째 원본 페이지를 검색합니다.
댓글과 답글
노트의 공개 댓글 한 페이지 또는 알고 있는 댓글 ID의 답글 한 페이지를 수집합니다.
Rednote API 사양 한눈에 보기
각 엔드포인트는 범위가 정해진 원본 요청을 받으며, 선언되지 않은 매개변수는 거부합니다.
| API 그룹 | 시작 입력 | 원본 범위 |
|---|---|---|
| 프로필과 사용자 노트 | url 또는 user_id | 프로필 하나 또는 원본 한 페이지, results_limit 없음 |
| 노트 상세 | 노트 경로와 xsec_token이 포함된 지원 URL | 노트 레코드 최대 1건 |
| 검색 | 비어 있지 않은 query와 지원하는 선택 enum | 고정된 첫 번째 원본 페이지, results_limit 없음 |
| 댓글과 답글 | 지원하는 노트 URL, 답글은 comment_id도 필요 | 원본 응답 한 페이지 |
| 홈 추천 | 모든 필드 선택 사항 | results_limit 1~40(기본값 20)의 한 페이지 |
Rednote API 작동 방식
8종의 엔드포인트 모두 같은 비동기 제출, 폴링, 저장된 결과 읽기 흐름을 따릅니다.
1. 엔드포인트 선택
공개 데이터 작업에 맞는 프로필, 노트, 검색, 댓글, 답글, 추천 엔드포인트를 고릅니다.
2. 올바른 입력 제출
선언된 필드만 POST하고 반환된 task_id를 저장합니다.
3. 정규화된 결과 읽기
작업이 종료 상태가 될 때까지 폴링한 뒤 data.results.items를 읽고, 저장된 결과를 페이지로 나눌 때만 next_cursor를 사용합니다.
SocQ API 키로 인증하고 검색어와 지원하는 선택 필터를 제출합니다. 성공한 Rednote 작업은 건당 1 크레딧의 고정 요금이 부과됩니다.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"travel guide","sort_by":"general","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successRednote API 주요 활용 사례
크리에이터·콘텐츠 리서치
공개 계정 식별 정보와 작성한 노트의 범위가 정해진 한 페이지를 함께 살펴봅니다.
주제 탐색
노트 검색, 사용자 검색, 홈 추천 스냅샷을 수집 타임스탬프와 함께 비교합니다.
대화 내용 검토
공개 노트의 댓글과 선택한 댓글의 중첩 답글을 정규화된 레코드로 확인합니다.
제한 사항과 공개 데이터 정책
이 엔드포인트는 범위가 정해진 원본 요청으로 공개 데이터를 읽으며, 계정 작업이나 비공개 접근은 제공하지 않습니다.
- 지원하는 URL 호스트는 xiaohongshu.com, xhslink.com과 그 하위 도메인입니다. Note Detail은 여기에 더해 /explore/{id} 또는 /discovery/item/{id} 경로와 비어 있지 않은 xsec_token이 필요합니다.
- user_id와 comment_id는 영문 ASCII 문자, 숫자, 콜론, 밑줄, 하이픈으로 이루어진 1~256자를 받습니다.
- Search Notes의 sort_by, media_type, published_within은 나열된 enum 값만 받고, Search Users는 query만 받습니다.
- results_limit은 Home Recommendations에서만 받으며, 범위는 1~40이고 기본값은 20입니다.
- 성공한 Rednote 작업은 건당 1 크레딧의 고정 요금이 부과됩니다.
Rednote API 자주 묻는 질문
Rednote API란 무엇인가요?
Rednote API는 공개 프로필, 노트, 댓글, 중첩 답글, 검색 결과, 홈 추천을 정규화된 레코드로 가져옵니다.
어떤 엔드포인트가 results_limit을 받나요?
Home Recommendations만 1부터 40까지의 정수로 results_limit을 받습니다. 다른 Rednote 엔드포인트는 이 값을 거부합니다.
Note Detail은 아무 Rednote URL이나 받나요?
아니요. 허용된 호스트, /explore/{id} 또는 /discovery/item/{id} 경로, 비어 있지 않은 xsec_token 쿼리 값이 필요합니다.
Rednote 요청 요금은 어떻게 되나요?
성공한 작업은 건당 1 SocQ 크레딧의 고정 요금이 부과됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Kwai API
공개 Kwai 프로필, 계정 게시물 한 페이지, 이미 알고 있는 게시물 하나를 정규화된 식별 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여도와 함께 가져옵니다.
Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.
Google Ad Library API
공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.
Google Maps API
공개 장소를 찾고, 이미 알고 있는 Maps URL의 정규화된 상세 정보를 가져오고, 출처가 연결된 장소·작성자 정보와 함께 공개 리뷰를 수집합니다.
Amazon API
지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.
Apple App Store API
이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.







