Xiaohongshu API 사용자 매뉴얼
통화 우선순위
App V2(권장) > App V1(통합) > Web V3(세 번째 대안)
⚠️ Web V2 및 이전 Web 시리즈는 더 이상 권장되지 않습니다. 새 프로젝트에서는 호출하지 마세요. 가능한 한 빨리 기존 프로젝트를 마이그레이션하세요.
- API 문서(Swagger UI): https://api.tikhub.io/#/Xiaohongshu-App-V2-API
- API 문서(Apifox): https://docs.tikhub.io/420136391e0
참고: API 키 권한을 편집하려면 TikHub 사용자 백엔드로 이동하세요. App V2의 범위는
/api/v1/xiaohongshu/app_v2/이고, Web V3의 범위는/api/v1/xiaohongshu/web_v3/입니다.
시리즈 설명
| 시리즈 | 상태 | 설명 |
|---|---|---|
| 앱 V2 | ✅ 추천 | 최신 버전, 가장 안정적이고 가장 완벽한 기능, 우선 사용 |
| 앱 V1 | ✅ 이용 가능 | App V2를 사용할 수 없는 경우 대체 솔루션 |
| 웹 V3 | ✅ 이용 가능 | App V1을 사용할 수 없는 경우 사용되는 세 번째 대안 |
| 웹 V2 / 웹 이전 버전 | ❌ 지원 중단됨 | 더 이상 안정성이 보장되지 않습니다. |
기능 인터페이스 빠른 확인
1. 세부 사항 참고
앱 V2(선호)
| 인터페이스 | 엔드포인트 |
|---|---|
| 그래픽 노트 세부정보 가져오기 | CACHED_PATTERN_3_2_캐시됨 |
| 비디오 노트 세부정보 가져오기 | CACHED_PATTERN_3_3_캐시됨 |
앱 V1(전체)
| 인터페이스 | 엔드포인트 |
|---|---|
| 노트 정보 얻기 | CACHED_PATTERN_3_4_캐시됨 |
| 비디오 노트 정보 얻기 | CACHED_PATTERN_3_5_캐시됨 |
웹 V3(세 번째 대안)
| 인터페이스 | 엔드포인트 |
|---|---|
| 메모 세부정보 가져오기 | CACHED_PATTERN_3_6_캐시됨 |
2. 메모 메모
앱 V2(선호)
| 인터페이스 | 엔드포인트 |
|---|---|
| 메모 댓글 받기 | CACHED_PATTERN_3_7_캐시됨 |
| 메모 하위 댓글 받기 | CACHED_PATTERN_3_8_캐시됨 |
앱 V1(전체)
| 인터페이스 | 엔드포인트 |
|---|---|
| 메모 댓글 받기 | CACHED_PATTERN_3_9_캐시됨 |
| 아동 댓글 받기 | GET /api/v1/xiaohongshu/app/get_sub_comments |
웹 V3(세 번째 대안)
| 인터페이스 | 엔드포인트 |
|---|---|
| 메모 댓글 받기 | CACHED_PATTERN_3_11_캐시됨 |
| 아동 댓글 받기 | GET /api/v1/xiaohongshu/web_v3/fetch_sub_comments |
3. 사용자 정보
앱 V2(선호)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자 정보 가져오기 | CACHED_PATTERN_3_13_캐시됨 |
앱 V1(전체)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자 정보 가져오기 | CACHED_PATTERN_3_14_캐시됨 |
웹 V3(세 번째 대안)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자 정보 가져오기 | CACHED_PATTERN_3_15_캐시됨 |
4. 사용자 노트 목록
앱 V2(선호)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자가 게시한 노트 받기 | GET /api/v1/xiaohongshu/app_v2/get_user_posted_notes |
| 사용자 컬렉션 메모 받기 | CACHED_PATTERN_3_17_캐시됨 |
앱 V1(전체)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자 메모 받기 | CACHED_PATTERN_3_18_캐시됨 |
웹 V3(세 번째 대안)
| 인터페이스 | 엔드포인트 |
|---|---|
| 사용자 메모 목록 가져오기 | GET /api/v1/xiaohongshu/web_v3/fetch_user_notes |
5. 검색
앱 V2(선호)
| 인터페이스 | 엔드포인트 |
|---|---|
| 노트 검색 | GET /api/v1/xiaohongshu/app_v2/search_notes |
| 사용자 검색 | CACHED_PATTERN_3_21_캐시됨 |
| 이미지 검색 | CACHED_PATTERN_3_22_캐시됨 |
| 제품 검색 | CACHED_PATTERN_3_23_캐시됨 |
| 그룹 검색 | CACHED_PATTERN_3_24_캐시됨 |
앱 V1(전체)
| 인터페이스 | 엔드포인트 |
|---|---|
| 노트 검색 | CACHED_PATTERN_3_25_캐시됨 |
| 노트 검색 V2 | GET /api/v1/xiaohongshu/app/search_notes_v2 |
| 사용자 검색 | CACHED_PATTERN_3_27_캐시됨 |
웹 V3(세 번째 대안)
| 인터페이스 | 엔드포인트 |
|---|---|
| 노트 검색 | CACHED_PATTERN_3_28_캐시됨 |
| 사용자 검색 | GET /api/v1/xiaohongshu/web_v3/fetch_search_users |
| 검색 연관 단어 가져오기 | GET /api/v1/xiaohongshu/web_v3/fetch_search_suggest |
| 인기 검색어 얻기 | GET /api/v1/xiaohongshu/web_v3/fetch_trending |
6. 홈피드
웹 V3(사용 가능)
| 인터페이스 | 엔드포인트 |
|---|---|
| 홈페이지 추천 받기 | GET /api/v1/xiaohongshu/web_v3/fetch_homefeed |
| 홈페이지 카테고리 목록 가져오기 | CACHED_PATTERN_3_33_캐시됨 |
7. 주제
**압