TikHub Xiaohongshu API 대안: 엔드포인트 95개 요금 분석과 실제 호출 11회로 비교
TikHub는 Xiaohongshu 요청 1건당 $0.01을 과금합니다. 실제 호출 11회로 측정한 결과 검색은 결과 1,000건당 $0.278로 1.8~6배 저렴했지만, 프로필은 1.8배 저렴한 데 그쳤습니다.

TikHub는 권장하는 Xiaohongshu(rednote) 검색 엔드포인트에 요청 1건당 $0.01을 과금합니다. FAQ에 따르면 한 페이지에는 결과가 약 6~20개 담기므로, 검색 결과 1,000건의 비용은 $0.50~$1.67입니다. 2026년 11월 5일 싱가포르 시간(SGT) 00:17에 EveryInfra xiaohongshu/search를 두 페이지 호출했습니다. 결과 40건에 총 $0.011112가 과금되어, 결과 1,000건당 $0.278입니다. TikHub보다 1.8~6.0배 저렴합니다.
격차가 큰 것은 페이지 단위로 반환되는 데이터뿐입니다. 노트 상세 1건이나 사용자 프로필 1건 같은 단일 객체는 TikHub가 $0.01, EveryInfra가 $0.005556을 과금해 차이가 1.8배에 그칩니다. 또한 Xiaohongshu는 EveryInfra 카탈로그에서도 가격이 높은 편으로, 단가 중앙값 기준 106개 플랫폼 중 15위입니다. 그래서 아래에 호출 횟수를 줄이는 방법을 별도 섹션으로 정리했습니다.
TikHub가 문서 페이지에 공개한 가격표의 Xiaohongshu 행도 모두 확인했습니다(2026년 11월 5일 00:13 SGT 열람). 가격이 매겨진 엔드포인트 95개 중 42개는 TikHub 스스로 지원 중단(deprecated)으로 표시한 시리즈에 속합니다. $0.001인 엔드포인트 5개 중 4개도 이 지원 중단 시리즈에 있습니다.
이 글은 반환된 행 1,000개당 비용이라는 하나의 단위를 사용합니다. 요청에 실제로 과금된 금액을 실제로 반환된 행 수로 나눈 뒤 1,000을 곱해 구합니다. EveryInfra 쪽은 요청에 지정한 수가 아니라 항상 반환된 행 수를 사용합니다. TikHub 쪽은 공개 자료만 사용합니다. 사용한 자료는 요금 페이지, FAQ, rednote API 페이지입니다.
OpenAPI 파일과 공개 가격표 문서 페이지도 참고했습니다. 2026년 11월 5일 00:13~00:15 SGT에 열람했습니다. TikHub 계정을 만들거나 데이터 엔드포인트를 호출하지는 않았습니다. 따라서 아래의 TikHub 수치는 모두 실제 청구액이 아니라 공개 가격에 공개 페이지 크기를 곱한 값입니다.

전체 비교표: TikHub Xiaohongshu 엔드포인트와 EveryInfra 기능
아래 표는 직접 확인할 수 있는 수치를 한곳에 모았습니다. TikHub 단가는 가격표의 endpoint_cost 필드에서 가져왔습니다. TikHub 페이지 크기는 FAQ 질문 “What page sizes should I expect?”에서 가져왔습니다. 이 답변에 따르면 페이지 단위 Xiaohongshu 엔드포인트는 호출당 약 6~20개 항목을 반환하며, 첫 페이지는 더 적을 수 있습니다.
사용자 검색은 예외입니다. TikHub 사용자 검색 가이드에는 페이지당 사용자 20명으로 고정되어 있다고 명시되어 있습니다. EveryInfra 단가는 같은 날의 Xiaohongshu 카탈로그에서 가져왔습니다. EveryInfra의 행 수와 과금액은 실제 호출의 원본 응답에서 가져왔습니다.
| 데이터 | TikHub 엔드포인트(유지 관리 시리즈) | TikHub 가격 / 페이지 | TikHub 1,000건당 | EveryInfra 기능 | 실측: 호출 / 행 / 과금액 | EveryInfra 1,000건당 가격 | 배율 |
|---|---|---|---|---|---|---|---|
| 노트 검색 | app_v2/search_notes | $0.01 / 6-20 | $0.50-$1.67 | xiaohongshu/search | 2 / 40 / $0.011112 | $0.278 | 1.8-6.0 |
| 최상위 댓글 | app_v2/get_note_comments | $0.01 / 6-20 | $0.50-$1.67 | xiaohongshu/comments | 2 / 30 / $0.011112 | $0.370 | 1.35-4.5 |
| 사용자 노트 목록 | app_v2/get_user_posted_notes | $0.01 / 6-20 | $0.50-$1.67 | xiaohongshu/user_posts | 1 / 21 / $0.005556 | $0.265 | 1.9-6.3 |
| 사용자 검색 | app_v2/search_users | $0.01 / 20 | $0.50 | xiaohongshu/search_users | 1 / 20 / $0.005556 | $0.278 | 1.8 |
| 노트 상세 | app_v2/get_image_note_detail | $0.01 / 1 | $10.00 | xiaohongshu/note | 1 / 1 / $0.005556 | $5.56 | 1.8 |
| 사용자 프로필 | app_v2/get_user_info | $0.01 / 1 | $10.00 | xiaohongshu/profile | 1 / 1 / $0.005556 | $5.56 | 1.8 |
| 인기 급상승 목록 | web_v3/fetch_hot_list | $0.001 / 명시 안 됨 | 명시 안 됨 | xiaohongshu/trending | 1 / 20 / $0.005556 | $0.278 | TikHub 단가가 5.6배 낮음 |
모든 배율은 TikHub 가격을 EveryInfra 가격으로 나눈 값입니다. 범위의 양 끝은 TikHub 쪽 페이지당 20행과 6행에 해당합니다. 이 표를 읽을 때 알아 둘 점이 세 가지 있습니다.
첫째, 격차가 가장 큰 세 항목은 모두 페이지 단위 데이터입니다. TikHub가 페이지당 반환하는 행이 적을수록 1,000건당 비용이 올라갑니다. TikHub가 20행이 꽉 찬 페이지를 반환하면 EveryInfra의 우위는 단가 차이인 1.8배로 줄고, 댓글은 1.35배까지 줄어듭니다. 둘째, 마지막 행은 TikHub가 더 저렴한 항목입니다.
TikHub가 유지 관리하는 Web V3 시리즈에는 $0.001짜리 인기 급상승 엔드포인트가 있으며, 이는 EveryInfra xiaohongshu/trending 가격의 1/5.6입니다. 이 엔드포인트는 공개 OpenAPI 파일에 없고 TikHub가 반환 행 수도 밝히지 않으므로 직접 테스트해야 합니다. 셋째, TikHub PGY 시리즈에는 개당 $0.02인 인플루언서 데이터 엔드포인트가 18개 있는데, EveryInfra는 그중 하나만 지원합니다. 아래 지원 범위 섹션에 목록이 있습니다.
양쪽의 1,000건당 수치는 어떻게 계산하나
양쪽 모두 같은 공식을 씁니다. 행 1,000개를 얻는 데 필요한 요청 수를 센 다음 요청당 가격을 곱합니다. TikHub 쪽 요청 수는 1,000을 페이지 크기로 나눈 뒤 올림한 값입니다. 요청을 반만 보낼 수는 없기 때문입니다. 페이지당 6~20행이면 검색에 요청이 50~167건 필요합니다. 건당 $0.01이므로 $0.50~$1.67입니다.
EveryInfra 쪽은 카탈로그 가격으로 추정하지 않습니다. 각 응답에서 count와 billing.charged_usd를 가져와 총 과금액을 총 행 수로 나누고 1,000을 곱합니다. 검색 2페이지는 40행에 $0.011112였으므로 $0.278입니다. 댓글 2페이지는 30행에 $0.011112였으므로 $0.370입니다.
모든 호출은 2026년 11월 5일 테스트 키 하나로 실행했습니다. 표에는 각 호출을 순서대로 나열하고, 반환된 행 수와 응답에 표시된 과금액을 함께 적었습니다.
| 시각(SGT) | 기능 | 행 | `charged_usd` | 비고 |
|---|---|---|---|---|
| 00:17:04 | xiaohongshu/search 1페이지 | 20 | $0.005556 | 중국어 키워드, 옵션 없음 |
| 00:17:41 | xiaohongshu/search 2페이지 | 20 | $0.005556 | 1페이지의 page_token |
| 00:17:59 | xiaohongshu/note | 1 | $0.005556 | 검색 결과의 URL |
| 00:18:31 | xiaohongshu/comments 1페이지 | 15 | $0.005556 | 댓글 253개인 노트 |
| 00:18:34 | xiaohongshu/comments 2페이지 | 15 | $0.005556 | 1페이지와 중복 1건 |
| 00:18:42 | xiaohongshu/comments_batch | 30 | $0.011111 | 노트 2개, units 2 |
| 00:18:51 | xiaohongshu/user_posts | 21 | $0.005556 | 고정 노트 1개 포함 |
| 00:18:54 | xiaohongshu/profile | 0 | $0 | 429, 키 제한, 3회 시도 |
| 00:22:08 | xiaohongshu/profile | 1 | $0.005556 | 재시도 성공 |
| 00:22:16 | xiaohongshu/note | 0 | $0 | 존재하지 않는 노트, 환불됨 |
| 00:23:47 | xiaohongshu/search | 0 | $0 | 422, 알 수 없는 page 파라미터 |
| 00:23:57 | xiaohongshu/trending | 20 | $0.005556 | 기본 목록 |
| 00:25:31 | xiaohongshu/search_users | 20 | $0.005556 | 비즈니스 계정 7개 |
데이터를 반환한 호출 11회의 총 과금액은 $0.061115입니다.
이 방법에는 두 가지 편향이 있으며 둘 다 알아 두어야 합니다. 첫째, TikHub에는 페이지 크기 범위 전체를 적용하지만 EveryInfra는 키워드 하나, 노트 하나, 계정 하나만 테스트했습니다. 드문 키워드라면 EveryInfra 검색 페이지도 20행보다 적게 반환될 수 있습니다. 2026년 11월 2일, Claude Code로 Xiaohongshu 댓글 수집하기 글을 위해 테스트를 진행했습니다.
그 테스트에서는 xiaohongshu/comments 8페이지 중 여러 페이지가 10행만 반환했습니다. 이 비율이면 EveryInfra 비용은 1,000건당 $0.556로, 20행이 꽉 찬 페이지 기준 TikHub 비용과 거의 같습니다. 이 경우에는 TikHub가 약간 더 저렴합니다.
둘째, 댓글은 중복될 수 있습니다. 이번 테스트에서는 댓글 하나가 같은 id로 1페이지와 2페이지에 모두 나타났습니다. 고유 댓글 29개만 세면 EveryInfra 비용은 1,000건당 $0.383입니다. 따라서 이 글의 수치는 2026년 11월 5일 샘플을 기준으로 합니다. 보장값이 아니라 규모를 가늠하는 기준입니다. 끝부분의 시작하기 섹션에서 직접 고른 키워드로 계산을 재현하는 방법을 안내합니다.
TikHub의 Xiaohongshu 가격표: 엔드포인트 95개 중 42개가 지원 중단 시리즈
TikHub는 모든 엔드포인트의 가격표를 공개합니다(“get all endpoints information”, 문서 페이지). 각 행에는 경로, 단가 endpoint_cost, 무료 크레딧 플래그 allow_free_credit, 할인 플래그 allow_discount, 요청 속도 제한 rate_limit이 있습니다. 2026년 11월 5일 00:13:25 SGT에 열람했습니다. 행은 1,472개, 고유 경로는 1,471개였습니다. 이 중 95개 경로에 /xiaohongshu/가 포함됩니다. 95개 모두 요청 속도 제한이 초당 10건으로 표시되어 FAQ의 기본값과 일치합니다.
가격표의 타임스탬프는 로스앤젤레스 기준 11월 4일 08:13:25였습니다. 사용 로그가 로스앤젤레스 시간으로 기록된다는 FAQ 설명과 일치합니다. 11월 1일에 확인한 TikHub 요금 글에서는 1,470행이었으므로 4일 동안 2행이 추가되었습니다.

가격표의 각 경로에는 app_v2, pgy, web_v3, app, web, web_v2 중 하나의 시리즈 이름이 붙어 있습니다. TikHub rednote API 페이지는 이 시리즈들을 명확히 구분합니다. App V1(/xiaohongshu/app/), Web(/xiaohongshu/web/), Web V2는 지원 중단되었다고 밝히고, 개발자에게는 유지 관리 중인 App V2, PGY, Web V3로 개발하라고 안내합니다. 이 기준으로 나누면 가격이 매겨진 엔드포인트 95개 중 42개는 지원 중단 시리즈, 53개는 유지 관리 시리즈에 속합니다.
이어서 경로를 OpenAPI 파일 버전 5.3.2와 대조했습니다. 여기에 문서화된 Xiaohongshu 엔드포인트는 45개뿐입니다. 지원 중단된 엔드포인트는 하나도 포함되어 있지 않습니다. 유지 관리 중인 Web V3 시리즈조차 문서화된 엔드포인트는 5개이고, 나머지 7개는 가격표에만 나옵니다.
| 시리즈 | 상태(TikHub rednote API 페이지) | 가격표 내 엔드포인트 | OpenAPI 파일 수록 | 단가 |
|---|---|---|---|---|
| App V2 | 유지 관리, 권장 | 21 | 20 | 모두 $0.01 |
| PGY | 유지 관리 | 20 | 20 | $0.02 18개, $0.01 1개, $0 1개 |
| Web V3 | 유지 관리 | 12 | 5 | $0.01 11개, $0.001 1개 |
| App V1 | 지원 중단 | 17 | 0 | $0.01 15개, $0.001 1개, $0 1개 |
| Web | 지원 중단 | 17 | 0 | $0.01 12개, $0.001 3개, $0.011 1개, $0 1개 |
| Web V2 | 지원 중단 | 8 | 0 | 모두 $0.01, 유형은 서드파티로 표시 |
이 표는 엔드포인트를 고를 때 중요합니다. 유지 관리 시리즈의 유료 엔드포인트 52개는 평균 가격이 $0.01329입니다. PGY 시리즈가 $0.02이기 때문에 FAQ에 적힌 “$0.01 per request”보다 높습니다. 즉 $0.01은 App V2와 Web V3의 가격입니다.
PGY 시리즈에서 인플루언서 데이터를 구매하는 팀은 그 두 배를 냅니다. EveryInfra는 Xiaohongshu 기능 17개 중 16개가 호출당 $0.005556입니다. PGY 콘텐츠 랭킹인 xiaohongshu/pgy_content_square만 $0.016입니다.
저렴한 엔드포인트는 어디에 있나: $0.001인 5개 중 4개는 지원 중단
“tikhub xiaohongshu”를 검색하는 독자는 $0.001짜리 행 몇 개를 보고 저렴하게 시작할 수 있다고 기대하기 쉽습니다. 아래 표는 가격이 $0.01 미만인 Xiaohongshu 엔드포인트를 모두 나열합니다. 시리즈 상태는 위 페이지에서 가져왔습니다. 무료 크레딧 열과 할인 열은 가격표의 allow_free_credit, allow_discount 필드에서 가져왔습니다.
| 엔드포인트 | 가격 | 시리즈 상태 | 무료 크레딧 / 할인 | OpenAPI 파일 수록 |
|---|---|---|---|---|
web/get_note_info_v5(노트 상세) | $0.001 | 지원 중단 | 예 / 예 | 아니요 |
web/get_note_id_and_xsec_token | $0.001 | 지원 중단 | 예 / 예 | 아니요 |
web/sign(서명) | $0.001 | 지원 중단 | 예 / 예 | 아니요 |
app/get_user_id_and_xsec_token | $0.001 | 지원 중단 | 아니요 / 아니요 | 아니요 |
web_v3/fetch_hot_list(인기 급상승) | $0.001 | 유지 관리 | 아니요 / 아니요 | 아니요 |
가장 저렴한 노트 상세 엔드포인트인 web/get_note_info_v5는 $0.001로, EveryInfra xiaohongshu/note의 1/5.6입니다. 이 엔드포인트가 작동한다면 노트 상세는 TikHub가 5.6배 저렴합니다. 하지만 이 엔드포인트는 지원 중단된 Web 시리즈에 속합니다. TikHub FAQ의 “Which Rednote series is current?” 항목에 따르면 기존 App 및 Web 시리즈는 2026년 6월 13일에 완전히 종료되었습니다.
따라서 무료 크레딧과 할인이 적용되는 Xiaohongshu 엔드포인트 3개는 모두 종료된 시리즈에 있습니다. 유지 관리 중인 엔드포인트 53개는 모두 allow_free_credit과 allow_discount가 0입니다. FAQ의 “What do I get for free?” 항목은 $0.05 회원가입 크레딧이 기본 가격 기준 요청 약 50건에 해당한다고 설명합니다. 실제로는 이 크레딧으로 유지 관리 중인 Xiaohongshu 엔드포인트를 하나도 테스트할 수 없습니다.
TikHub 공개 자료 3곳, 현행 시리즈에 대한 설명이 서로 다르다
문서를 비교하던 중, TikHub 공개 자료 세 곳이 어떤 Xiaohongshu 시리즈가 아직 작동하는지에 대해 서로 다르게 설명한다는 사실을 확인했습니다.
| 출처 | 내용 | 차이점 |
|---|---|---|
| FAQ, “Which Rednote series is current?” | App V2가 현행이고 Web V3는 대체 수단입니다. 기존 App과 Web은 2026년 6월 13일에 종료되었습니다. Web V2는 유지 관리되지 않습니다. | 종료일이 6월 13일 |
| Rednote API 페이지 | 유지 관리: App V2, PGY, Web V3. 지원 중단: App V1, Web, Web V2. | FAQ와 일치하며 PGY를 추가로 명시 |
| Xiaohongshu API 가이드(TikHub 블로그, 중국어) | App V1과 Web 시리즈(Web V2, Web V3)는 2026년 6월 17일부터 영구적으로 중단되었습니다. App V2가 유일하게 지원되는 시리즈이므로 대체 수단이 필요하지 않습니다. | Web V3를 중단된 것으로 보며, 날짜는 6월 17일 |
| OpenAPI 파일, v5.3.2 | App V2 20개, PGY 20개, Web V3 5개 엔드포인트를 문서화 | Web V3가 여전히 문서화되어 있음 |
| 공개 가격표 | 6개 시리즈의 엔드포인트 95개 모두 가격이 있음 | 지원 중단된 엔드포인트 42개에도 여전히 가격이 표시됨 |
차이가 하나 더 있습니다. FAQ의 “Can I list notes by topic or tag?” 항목은 주제 목록을 지원하지 않으며 기존 get_notes_by_topic 엔드포인트는 유지 관리되지 않는다고 설명하고, 대신 키워드 검색을 권합니다. 하지만 App V2 주제 피드 엔드포인트는 OpenAPI 파일과 가이드에 모두 있으며 가격은 $0.01입니다.
TikHub 계정이 없어 어느 설명이 최신인지 테스트할 수는 없습니다. 각 설명을 있는 그대로 정리했습니다. 권장 사항은 간단합니다. App V2를 기반으로 개발하고, Web V3는 “작동할 수도 있음” 정도로 취급하며, $0.001짜리 행을 기준으로 예산을 세우지 않는 것이 좋습니다.
테스트 1: 노트 검색, 2페이지에서 40행을 $0.011에 수집
2026년 11월 5일 00:17:04 SGT에 “패딩 추천”을 뜻하는 중국어 키워드로 xiaohongshu/search를 호출했습니다. 선택 파라미터는 보내지 않았습니다. 20행이 반환되었고 $0.005556이 과금되었습니다. 00:17:41 SGT에 반환된 next_page_token을 그대로 다시 전달해 2페이지를 받았고, 20행이 추가로 반환되어 $0.005556이 과금되었습니다.
id 기준으로 중복을 제거한 결과 40행 모두 고유했습니다. 카탈로그에는 이 기능의 page_size가 20이며 limit은 효과가 없다고 나와 있습니다. 페이지 토큰은 24시간 동안 유효합니다. 두 페이지 모두 꽉 찬 상태로 반환되었습니다.
40행을 보면 기본 정렬이 무엇을 반환하는지 알 수 있습니다. 40개 중 동영상 노트는 1개뿐이었습니다. 40개 중 35개는 2026년 10월 6일 또는 그 이후에 게시되었으며, 이는 호출 시점 기준 30일 이내입니다. 좋아요 수의 중앙값은 130, 최댓값은 8,822, 최솟값은 0이었습니다.
가장 최근 노트는 11월 4일 19:18 SGT에 게시되어 호출 시점보다 겨우 5시간 전이었습니다. 광군제 전후로 겨울 의류를 모니터링하는 브랜드라면, 기본 정렬이 이미 최근 노트를 우선한다는 뜻입니다. date_range가 필요하지 않을 수도 있습니다. 카탈로그는 date_range=last_30_days 같은 필터를 쓰면 20행보다 적은 페이지가 반환될 수 있고, 그러면 1,000건당 비용이 올라간다고 경고합니다.
시작할 때 중요한 세부 사항이 하나 있습니다. 결과 URL 40개에 모두 xsec_token이 포함되어 있습니다. TikHub FAQ의 “Where does the xsec_token come from?” 항목에 따르면 xsec 토큰은 더 이상 TikHub API 응답에 반환되지 않으므로 웹 링크의 쿼리 문자열에서 직접 복사해야 합니다. Web V3 노트 상세 엔드포인트는 note_id와 xsec_token이 모두 필요합니다. App V2 엔드포인트는 대신 share_text 공유 링크를 받습니다.
EveryInfra에서는 검색 결과의 URL을 xiaohongshu/note, xiaohongshu/comments, xiaohongshu/comments_batch에 그대로 전달할 수 있습니다. 이어지는 세 테스트는 모두 검색 결과에서 복사한 URL을 별도 파싱 없이 사용했습니다.
TikHub 노트 검색 가이드는 1부터 시작하는 page 번호로 페이지를 넘깁니다. 다음 페이지를 요청할 때마다 첫 응답의 search_id와 search_session_id를 다시 보내야 합니다. 정렬 순서는 종합, 최신순, 좋아요 많은 순, 댓글 많은 순, 저장 많은 순, 영어 우선의 6가지입니다. 시간 필터는 1일, 1주일, 반년입니다.
EveryInfra의 sort에는 관련도순, 최신순, 좋아요 많은 순, 댓글 많은 순, 저장 많은 순의 5가지 값이 있습니다. date_range에는 최근 30일과 최근 1년이 추가로 있습니다. 20행이 꽉 찬 페이지 기준으로 TikHub는 1,000건당 $0.50로 EveryInfra 측정 비용의 1.8배입니다. 페이지당 6행이면 $1.67로 6.0배입니다.
테스트 2: 댓글과 다중 노트 일괄 요청, 30행 중 중복 1건
00:18:31 SGT에 첫 검색 페이지의 노트 하나로 xiaohongshu/comments를 호출했습니다. 이 노트에는 댓글이 253개 있었습니다. 1페이지는 15행을 반환했습니다. 00:18:34 SGT에 페이지 토큰을 보내 2페이지를 받았고 15행이 추가로 반환되었습니다. 두 페이지는 30행에 $0.011112로, 1,000건당 $0.370입니다. 카탈로그의 페이지 크기는 15이며 두 페이지 모두 꽉 찼습니다.
일반 댓글 하나가 같은 id로 두 페이지에 모두 나타났습니다. 고유 행 29개 기준으로는 1,000건당 $0.383입니다. 댓글 30개 중 3개에는 이미지가 있었고, 1개는 노트 작성자의 답글이었습니다. 댓글에는 인라인 하위 답글이 8개 포함되었지만 sub_comment_count 값을 합하면 71개입니다. 모든 답글을 가져오려면 댓글마다 xiaohongshu/sub_comments를 호출해야 합니다.
TikHub 노트 댓글 가이드는 cursor, index, pageArea 세 필드로 페이지를 넘깁니다. 기본 정렬은 최신순(latest_v2)입니다. 가이드 스스로 기본 정렬에서는 페이지를 넘기는 동안 댓글이 누락되거나 중복될 수 있다고 경고합니다. 가이드에 페이지 크기는 명시되어 있지 않습니다.
FAQ는 페이지 단위 Xiaohongshu 엔드포인트가 호출당 약 6~20개를 반환하며 첫 페이지는 더 적을 수 있다고 설명합니다. 6~20개 기준이면 TikHub는 댓글 1,000건당 $0.50~$1.67로 EveryInfra 비용의 1.35~4.5배입니다. 공정하게 말하면, TikHub가 페이지당 꾸준히 20개를 반환할 경우 차이는 1,000건당 $0.13에 불과합니다. 페이지 단위 데이터 중 EveryInfra의 우위가 가장 작은 것이 댓글입니다.
00:18:42 SGT에 xiaohongshu/comments_batch를 시도했습니다. 요청 1건에 노트 URL 2개를 담았습니다. 노트당 15행씩 30행이 반환되었고, billing.units가 2로 설정되어 $0.011111이 과금되었습니다. 이 기능은 대상 노트당 과금되며 요청당 최대 20개 노트를 처리합니다. 따라서 단건 호출보다 비용이 줄지는 않습니다. 대신 요청 수와 코드가 줄어듭니다. 요청 1건으로 노트 20개의 첫 댓글 페이지를 가져올 수 있습니다.
TikHub FAQ의 “What does Rednote cost?” 항목에는 “Notes are fetched one at a time — there is no batch note endpoint.”라고 적혀 있습니다. 이 문장은 노트에 관한 내용입니다. TikHub의 Xiaohongshu 가격표에서도 일괄 댓글 엔드포인트는 찾을 수 없었습니다. 매일 수백 개 노트의 초반 댓글을 살펴본다면 이 차이가 단가보다 더 중요합니다.
테스트 3: 프로필과 노트 목록, 단일 객체가 더 비싼 이유
00:18:51 SGT에 위 노트의 작성자를 대상으로 xiaohongshu/user_posts를 호출했습니다. 21행이 반환되어 카탈로그 페이지 크기 20보다 1행 많았습니다. 추가된 1행은 is_pinned가 true인 고정 노트였습니다. 21개 노트 중 18개가 동영상이었습니다.
가장 오래된 노트는 2026년 3월 18일, 가장 최근 노트는 11월 4일에 게시되었고, 응답에는 다음 페이지 토큰이 있었습니다. 비용은 1,000건당 $0.265로 EveryInfra 페이지 단위 데이터 중 가장 낮았습니다. TikHub 사용자 노트 가이드는 마지막 노트의 cursor로 페이지를 넘기며 페이지 크기는 명시하지 않습니다. FAQ 범위인 6~20개 기준으로 TikHub는 1,000건당 $0.50~$1.67로 EveryInfra 비용의 1.9~6.3배입니다.
프로필은 다릅니다. 00:18:54 SGT에 xiaohongshu/profile 호출이 HTTP 429를 받았습니다. 이 테스트 키에 분당 10회 제한을 설정해 두었기 때문입니다. 계정 기본값은 분당 60회입니다. 응답에는 reason이 key_limit, retry_after가 6초로 표시되었고 “Nothing was charged”라는 문구가 있었습니다.
00:19:54 SGT와 00:20:54 SGT에 시도한 재시도도 다시 429를 받았으며, 세 번의 429 응답 모두 비용이 청구되지 않았습니다. 00:22:08 SGT의 재시도는 성공했습니다. 팔로워 수, 좋아요·저장 수, 노트 수, IP 위치, 인증 상태 등 18개 필드가 채워진 계정 객체 하나가 반환되었고, 청구 금액은 $0.005556였습니다. 이 계정은 팔로워가 200,000명에 가까운 일반 크리에이터이므로 이름을 밝히지 않습니다.
프로필 호출은 양쪽 모두 계정 하나를 반환합니다. TikHub 사용자 정보 가이드도 마찬가지이며 건당 $0.01입니다. 따라서 프로필 100개는 $1.00 대 $0.56로, 차이는 1.8배에 그칩니다.
계정 목록의 팔로워 수와 인증 여부만 필요하다면 프로필 호출을 건너뛸 수 있습니다. 00:25:31 SGT에 “패딩”을 뜻하는 중국어 키워드로 xiaohongshu/search_users를 호출했습니다. 한 페이지에 계정 20개가 반환되었습니다. 각 행에는 팔로워 수, 인증 여부, 인증 유형이 있었습니다. 20개 중 7개는 비즈니스 인증 계정이었습니다. 이 호출에는 $0.005556이 과금되었습니다.
5페이지면 계정 100개를 $0.028에 선별할 수 있습니다. 프로필 호출 100회는 $0.56로 20배 더 비쌉니다. 대신 사용자 검색은 필드를 9개만 반환하며 소개, 좋아요 총수, IP 위치는 없습니다. 먼저 사용자 검색으로 선별한 뒤 중요한 몇몇 계정에만 프로필을 호출하는 방식이 좋습니다. TikHub 사용자 검색은 페이지당 20개 고정에 $0.01이므로 계정 100개에 $0.05로, EveryInfra 비용의 1.8배입니다.
테스트 4: 빈 결과, 잘못된 파라미터, 요청 속도 제한
TikHub는 모든 HTTP 200에 과금합니다. FAQ의 “What exactly gets billed?” 항목에 따르면 성공한 요청에만 과금되며, 200을 반환하면 성공한 요청입니다. 문제는 Xiaohongshu에서 “성공”의 범위가 넓다는 점입니다. OpenAPI 파일에 문서화된 Xiaohongshu 엔드포인트 45개의 설명을 모두 읽었습니다. 그중 33개는 ID가 잘못되었거나 누락된 경우, 공유 링크 파싱에 실패한 경우, 결과가 비어 있는 경우에도 과금된다고 명시합니다. App V2 엔드포인트 13개와 PGY 엔드포인트 20개 전부가 여기에 해당합니다.
App V2 설명에 따르면 노트 ID가 잘못되어도 엔드포인트는 data에 “service error” 메시지를 담아 응답하고, 해당 요청은 정상적으로 과금됩니다. PGY 설명에 따르면 data가 null인 빈 결과를 포함해 HTTP 200은 과금됩니다. HTTP 400만 무료입니다.

이번 테스트에서 데이터를 반환하지 않은 호출은 3회였고 모두 과금되지 않았습니다. 00:22:16 SGT에 24자리 ID가 모두 0인 노트 링크로 xiaohongshu/note를 호출했습니다. 200과 함께 빈 results, billing.charged_usd 0, reason empty_result_refunded, refund.status succeeded가 반환되었습니다. 00:23:47 SGT에는 TikHub 사용자가 하듯 일부러 page 파라미터를 넣어 xiaohongshu/search를 호출했습니다.
응답은 코드 unknown_param과 함께 422였습니다. 오류에는 허용되는 파라미터 6개와 작동하는 예시 요청이 나열되었고, 마지막에 “Nothing was charged”라는 문구가 있었습니다. 세 번째는 테스트 3의 429입니다. 아래 표에 경우별 규칙을 나란히 정리했습니다.
| 사례 | TikHub(문서 내용) | EveryInfra(이번 테스트) |
|---|---|---|
| 노트 또는 사용자 ID가 존재하지 않음 | App V2가 응답하고 $0.01 과금 | 빈 결과, 보류 금액 환불, $0 과금 |
PGY 빈 결과(data가 null) | HTTP 200, $0.02 과금 | 해당 없음(콘텐츠 랭킹만 지원) |
| 잘못된 파라미터 | HTTP 400은 무료. FAQ에는 일부 400은 일시적이므로 재시도를 권장한다고 나와 있음 | 허용 파라미터와 예시가 담긴 422, $0 |
| 요청 속도 제한 초과 | 429, 무료 | retry_after가 포함된 429, 무료 |
| 기본 요청 속도 제한 | 초당 10건(분당 600건) | 계정의 모든 키 합산 분당 60건 |
마지막 행은 TikHub가 유리한 항목입니다. TikHub 기본값인 초당 10건은 EveryInfra 기본값의 10배입니다. EveryInfra에서 분당 600건을 쓰려면 30일간 적용되는 $30 부스트를 구매하면 됩니다. 누적 충전액이 $150 이상이면 무료로도 받을 수 있습니다(요금 참고).
그 위의 행들에는 일괄 작업에서 놓치기 쉬운 비용이 숨어 있습니다. 스프레드시트에서 노트 링크 10,000개를 내보냈는데 그중 5%의 노트가 삭제되었거나 링크가 만료되었다고 가정해 보겠습니다. TikHub에서는 이 500건의 호출에 $5.00의 비용이 듭니다. EveryInfra에서는 $0입니다.
지원 범위: TikHub에는 있고 EveryInfra에는 없는 것
단가만으로는 절반만 알 수 있습니다. 양쪽이 제공하는 Xiaohongshu 데이터가 같지 않기 때문입니다. 아래 표는 유지 관리 중인 TikHub 엔드포인트를 EveryInfra의 Xiaohongshu 기능 17개와 용도별로 대응시켰습니다. 지원 중단 시리즈는 제외했습니다.
| 용도 | TikHub 엔드포인트 | EveryInfra 기능 | 제공하는 곳 |
|---|---|---|---|
| 키워드 노트 검색 | app_v2/search_notes | xiaohongshu/search | 양쪽 모두 |
| 노트 상세(이미지 또는 동영상) | app_v2/get_image_note_detail, get_video_note_detail | xiaohongshu/note, xiaohongshu/video | 양쪽 모두 |
| 댓글 및 답글 | app_v2/get_note_comments, get_note_sub_comments | xiaohongshu/comments, xiaohongshu/sub_comments | 양쪽 모두 |
| 한 번의 요청으로 여러 노트의 댓글 조회 | 없음(FAQ: 노트 일괄 조회 엔드포인트 없음, 요금표에도 댓글 일괄 조회 엔드포인트 없음) | xiaohongshu/comments_batch, 노트 1-20개 | EveryInfra만 제공 |
| 프로필 및 노트 목록 | app_v2/get_user_info, get_user_posted_notes | xiaohongshu/profile, xiaohongshu/user_posts | 양쪽 모두 |
| 사용자가 공개한 저장 노트 | app_v2/get_user_faved_notes | 없음 | TikHub만 제공 |
| 팔로워 목록 | 없음 | xiaohongshu/followers_list | EveryInfra만 제공 |
| 사용자 검색 | app_v2/search_users | xiaohongshu/search_users | 양쪽 모두 |
| 이미지 검색, 그룹 검색 | app_v2/search_images, search_groups | 없음 | TikHub만 제공 |
| 토픽 정보, 토픽 피드 | app_v2/get_topic_info, get_topic_feed | xiaohongshu/hashtag(토픽 노트) | 토픽 정보: TikHub만 제공 |
| 상품 검색, 상세, 리뷰 | app_v2/search_products, get_product_detail, get_product_reviews | xiaohongshu/product_search, product_detail, reviews | 양쪽 모두 |
| 리뷰 개요, 상품 추천 | app_v2/get_product_review_overview, get_product_recommendations | 없음 | TikHub만 제공 |
| 크리에이터 인스피레이션, 검색어 추천, 홈 피드 | App V2 인스피레이션 피드 2종, web_v3/fetch_search_suggest, fetch_homefeed | 없음 | TikHub만 제공 |
| 인기 급상승 목록 | web_v3/fetch_hot_list, $0.001(문서 없음) | xiaohongshu/trending | 양쪽 모두 |
| 노트 위치 | 없음 | xiaohongshu/note_location | EveryInfra만 제공 |
| PGY 콘텐츠 랭킹 | pgy/get_content_square, $0.02 | xiaohongshu/pgy_content_square, $0.016 | 양쪽 모두 |
| PGY 인플루언서 상세, 오디언스 프로필, 성장 추이, 단가 데이터, 키워드 지수 | 그 밖의 유료 pgy/ 엔드포인트 17개 | 없음 | TikHub만 제공 |
PGY 행은 기능 범위 차이가 가장 큰 부분입니다. PGY(Pugongying)는 브랜드가 크리에이터를 섭외하는 Xiaohongshu 플랫폼입니다. TikHub는 여러 PGY 데이터 유형을 건당 $0.02에 판매합니다. 여기에는 크리에이터 상세(문서)와 연령, 성별, 지역, 기기, 관심사별 분포를 담은 오디언스 프로필(문서)이 포함됩니다. 크리에이터 마켓플레이스 검색(문서)과 검색 지수를 제공하는 키워드 개요(문서)도 있습니다.
인플루언서 에이전시가 크리에이터를 고르고 단가를 확인하는 데 필요한 것이 바로 이 데이터입니다. 저희는 콘텐츠 랭킹만 제공합니다(TikHub의 해당 엔드포인트 문서는 여기에 있습니다). 주된 작업이 "이 크리에이터 200명 각각의 오디언스 프로필 가져오기"라면 저희로는 할 수 없으니 TikHub를 사용하시기 바랍니다. TikHub FAQ에는 어느 쪽도 제공할 수 없는 수치도 하나 언급되어 있습니다. Xiaohongshu는 재생 수와 다운로드 수를 공개하지 않습니다.
전체 비용을 계산한 작업 예시: 브랜드 5곳을 모니터링하는 에이전시
영어권 독자는 뷰티, 아웃도어 의류, 와인처럼 중국에 판매하는 브랜드를 rednote에서 모니터링하는 경우가 많습니다. 브랜드 5곳을 추적하는 에이전시를 예로 들어 보겠습니다. 이 에이전시는 브랜드마다 매일 검색 결과 500개와 최상위 댓글 500개를 수집합니다. TikHub는 페이지당 20행과 6행 두 기준으로 계산했습니다. 저희 쪽은 실측한 페이지 크기인 검색 20행, 댓글 15행을 적용했습니다. 양쪽 모두 충전 수수료는 포함하지 않았습니다.
| 항목(일일, 브랜드 5곳) | TikHub 요청 수 | TikHub 비용 | EveryInfra 요청 수 | EveryInfra 비용 |
|---|---|---|---|---|
| 검색 결과 2,500개 | 125-420 | $1.25-$4.20 | 125 | $0.69 |
| 댓글 2,500개 | 125-420 | $1.25-$4.20 | 170 | $0.94 |
| 일일 합계 | 250-840 | $2.50-$8.40 | 295 | $1.64 |
| 30일 합계 | 7,500-25,200 | $75.00-$252.00 | 8,850 | $49.17 |
30일 기준으로 TikHub에서는 $75.00~$252.00가 들지만 EveryInfra에서는 $49.17로, 1.5~5.1배 차이가 납니다. TikHub FAQ에 따르면 Xiaohongshu 할인은 월 1백만 건 이상의 요청부터 적용됩니다. 이 작업은 월 7,500~25,200건의 요청을 사용하므로 그 기준에 한참 못 미치며, 따라서 정가를 기준으로 비교하는 것이 맞습니다. EveryInfra의 댓글 페이지는 15행 단위이므로 요청 수는 TikHub의 최선의 경우보다 많습니다. 그럼에도 TikHub 범위의 모든 지점에서 더 낮은 단가 덕분에 EveryInfra가 더 저렴합니다.
같은 계산을 저희가 모든 Xiaohongshu 비교에 사용하는 표준 작업, 즉 검색 결과 1,000개, 댓글 1,000개, 프로필 100개에도 적용할 수 있습니다. 아래 차트에 그 결과가 있습니다.
이 작업의 비용은 TikHub에서 $2.00~$4.34, 저희는 $1.21로 1.66~3.60배 차이입니다. 단일 객체 조회는 저희의 가격 우위가 가장 작은 부분이라 프로필이 전체 비용의 46%를 차지합니다. 사용자 검색 5페이지로 먼저 선별하면 비용이 $0.68로 줄어듭니다.
반대로 대부분 단일 객체 조회로 이루어진 작업도 있습니다. 하루에 노트 상세를 10,000건 가져온다고 가정해 보겠습니다. 비용은 TikHub에서 $100, 저희는 $55.56입니다. 양쪽 모두 요청당 노트 1개를 반환하므로 차이는 1.8배에서 더 벌어지지 않습니다.
충전, 무료 크레딧, 요청 속도 제한: 단가 외에 드는 비용
단가 외에도 비용과 제한이 있으며, 소규모 팀에는 이 부분이 중요합니다. TikHub 정보는 요금 페이지와 FAQ에서, 저희 정보는 요금 페이지와 문서에서 가져왔습니다. 모두 2026년 11월 5일에 확인했습니다.
| 항목 | TikHub | EveryInfra |
|---|---|---|
| 최소 충전 금액 | $5 | 요금 페이지의 최저 등급은 $10 |
| 결제 수수료 | Alipay 2.6% + $0.30. PayPal 및 USDT 5% + $0.30(FAQ 예시: PayPal로 $5 충전 시 $5.55) | 결제 수단에 따라 다름. 결제 전에 콘솔에서 결제 금액과 수수료 표시 |
| 무료 체험 | 이메일 인증 후 $0.05. 유지 관리되는 Xiaohongshu 엔드포인트에서는 사용 불가 | GitHub 저장소 2곳에 Star를 누르면 $1 지급, 24시간 유효. Xiaohongshu 호출 포함, 약 179회 |
| 환불 | TikHub가 엔드포인트 사용 불가를 확인한 경우를 제외하고 환불 불가(환불 정책, 2026년 7월 20일 업데이트) | 실패하거나 빈 결과가 반환된 호출은 건별로 잔액에 환급. 충전 잔액은 만료되지 않음 |
| 할인 | Xiaohongshu: 월 1백만 건 이상의 요청에만 적용 | 요금 페이지에는 정가 표시. 계정별 가격은 콘솔에서, 건별 과금액은 응답의 billing 필드에서 확인 |
| 기본 요청 속도 제한 | 초당 10건. 월 $5에 초당 20건, 월 $55에 최대 초당 100건 | 분당 60건. 30일당 $10에 분당 180건, 30일당 $30에 분당 600건 |
처음 테스트할 때는 무료 체험 행이 가장 중요합니다. TikHub에서 실제 Xiaohongshu 필드를 확인하려면 먼저 $5를 충전해야 하며, Alipay로는 $5.43이 듭니다. 저희는 $1 체험용 크레딧으로 $0.005556인 xiaohongshu/search를 179회 호출할 수 있습니다. 이 글의 실제 호출 11건을 12번 넘게 반복할 수 있는 양입니다. 요청 속도 제한은 반대로 TikHub가 훨씬 넉넉합니다. 몇 분 안에 링크 수천 개를 처리해야 하는 작업은 저희 기본 제한에서는 대기열에 쌓이며, 그렇지 않으려면 부스트를 구매해야 합니다.
Xiaohongshu는 저희 플랫폼 중 가격이 높은 편: 호출을 줄이는 방법
저희 카탈로그에서 Xiaohongshu는 호출당 $0.005556인 complex 등급에 속합니다. 이는 Douyin과 TikTok의 가장 저렴한 basic 등급 가격인 $0.000556의 10배입니다. 2026년 11월 5일 기준 전체 카탈로그에서 이 가격이 적용된 기능은 Douyin 16개, TikTok 13개였습니다. 따라서 Xiaohongshu 예산은 별도 항목으로 잡으시기 바랍니다. 표의 각 방법은 이번 테스트나 카탈로그에서 나온 것이며, 모두 금액으로 환산할 수 있습니다.
| 방법 | 대응 방법 | 이번 테스트의 예시 | 절감 효과 |
|---|---|---|---|
| 검색 결과 행 활용, 상세 조회 생략 | 제목, 좋아요, 저장, 댓글, 공유 수, 게시 시간, 작성자는 xiaohongshu/search에서 읽고, 전체 본문이나 해시태그가 필요할 때만 xiaohongshu/note 호출 | 노트 1,000개: 검색 호출 50회($0.28) 대 상세 호출 1,000회($5.56) | 20x |
| 계정 먼저 선별 | xiaohongshu/search_users로 팔로워 수와 인증 여부를 확인한 뒤 추린 목록만 프로필 호출 | 계정 100개: $0.028 대 $0.56 | 20x |
| 댓글 첫 페이지만 읽기 | xiaohongshu/comments_batch로 노트 최대 20개의 댓글 첫 페이지를 가져온 뒤, 필요한 노트만 다음 페이지를 추가로 조회 | 답글 8개가 이미 인라인으로 포함되어 해당 답글에는 sub_comments가 필요 없었음 | 요청 수 감소 |
| 페이지 토큰 보관 | 토큰은 24시간 유효하므로 중단된 작업을 마지막 토큰부터 이어서 실행 | 중단 후 1페이지 재요청 불필요 | 건너뛴 페이지만큼 |
id 기준 중복 제거 | 비용이나 커버리지를 계산하기 전에 고유 행 수 집계 | 댓글 30행 중 중복 1건(3.3%) | 정확한 비용 산출 |
절감 효과가 가장 큰 것은 첫 번째 방법입니다. 카탈로그에 따르면 검색 결과의 텍스트 필드는 약 60자 분량의 요약입니다. 분석에 참여 지표와 제목만 필요하다면 이 요약으로 충분하며, 단일 노트 호출 1,000건에 비용을 들일 필요가 없습니다. 같은 결과를 하루에 여러 번 읽는다면 사본을 저장해 두고 다시 호출하지 마십시오.
TikHub에는 참고할 만한 절감 방법이 하나 있습니다. 각 응답에 cache_url이 포함되며, 24시간 동안 무료로 다시 열어 볼 수 있습니다(rednote API 페이지 참고). 하지만 FAQ에는 같은 파라미터로 다시 요청하면 새 요청으로 과금된다고도 나와 있습니다. 따라서 cache_url은 캐시가 아니라 디버깅 보조 수단입니다.
MCP와 AI 도구: 양쪽의 연결 방법
양쪽 모두 MCP 클라이언트와 함께 사용할 수 있습니다. MCP(Model Context Protocol)는 AI 클라이언트가 외부 도구를 호출할 수 있게 하는 개방형 프로토콜입니다(사양 참고). 설정 방식은 서로 다릅니다.
TikHub MCP 페이지에 따르면 플랫폼마다 https://mcp.tikhub.io/{platform}/mcp 형식의 서버가 하나씩 있습니다. FAQ에 따르면 Xiaohongshu 서버의 도구는 71개입니다. Claude Desktop 같은 데스크톱 클라이언트는 npx mcp-remote로 원격 서버를 stdio에 연결하며, 이를 위해 Node.js가 필요합니다. FAQ에는 MCP, Chrome 확장 프로그램, Zapier, n8n도 직접 API 호출과 동일하게 과금된다고 나와 있습니다.
저희는 https://api.everyinfra.com/mcp 주소 하나만 사용합니다. 기본 엔트리의 도구는 12개이며, SGT 00:24:25에 키 없이 tools/list를 조회해 확인했습니다. Xiaohongshu와 그 밖의 100개가 넘는 플랫폼 모두 everyinfra_call_api 도구 하나로 호출합니다. 설정 방법은 MCP 서버 페이지에 있습니다.
| 항목 | TikHub | EveryInfra |
|---|---|---|
| 서버 주소 | 플랫폼별 1개, https://mcp.tikhub.io/{platform}/mcp | 1개, https://api.everyinfra.com/mcp |
| Xiaohongshu 도구 | 71개(FAQ) | everyinfra_call_api로 호출 |
| 기본 도구 수 | 서버 16개에 걸쳐 990개 이상 | 12개(tools/list, SGT 00:24:25) |
| 데스크톱 설정 | npx mcp-remote 브리지, Node.js 필요 | 클라이언트 설정에 URL과 헤더 입력 |
| 과금 | 직접 API 호출과 동일 | 직접 API 호출과 동일, 실패하거나 빈 결과가 반환된 호출은 무료 |
{
"mcpServers": {
"everyinfra": {
"url": "https://api.everyinfra.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}도구가 71개인 구성과 12개인 구성에는 각각 대가가 따릅니다. 도구가 많으면 AI가 "PGY 크리에이터 오디언스 프로필 조회"처럼 정확한 도구를 고를 수 있습니다. 하지만 클라이언트는 대화를 시작할 때마다 도구 설명 71개를 컨텍스트에 불러와야 합니다. AI가 잘못된 버전을 고를 가능성도 커집니다.
도구가 적으면 AI는 먼저 everyinfra_list_capabilities를 호출해 카탈로그를 읽은 다음 platform과 action을 채웁니다. 한 단계가 더 늘지만, 기능마다 가격이 하나이고 파라미터 작성 방식도 하나입니다. AI 에이전트로 Xiaohongshu 작업을 대량 실행할 때는 프롬프트에 기능과 페이지 크기를 명시하십시오. 예: "xiaohongshu/search로 20행씩 3페이지를 가져오고, id 기준으로 중복을 제거하세요." 그러면 에이전트가 한 번에 1행만 반환하는 노트 상세 호출로 돌아가지 않습니다.
curl과 필드: TikHub에서 옮겨 올 때 바꿔야 할 것
TikHub Xiaohongshu 엔드포인트는 쿼리 파라미터와 Authorization: Bearer 헤더를 사용하는 GET 방식입니다. 저희는 POST 주소 하나를 사용하며, 플랫폼과 기능은 요청 본문에 넣습니다. 아래는 테스트 1에서 보낸 요청 그대로입니다. 키는 본인의 키로 바꾸십시오.
curl -X POST https://api.everyinfra.com/api/v1/social \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"羽绒服推荐"}}'
# Next page: copy next_page_token from the response into page_token and keep the rest
curl -X POST https://api.everyinfra.com/api/v1/social \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"羽绒服推荐","page_token":"<next_page_token>"}}'변경 사항은 대부분 파라미터 이름과 데이터 경로입니다. TikHub는 각 응답을 code와 data로 감싸며, PGY 엔드포인트에는 data 계층이 하나 더 있습니다(문서에도 두 계층을 풀어야 한다고 나와 있습니다). 저희 응답에서는 행이 최상위 results에, 페이지 토큰이 최상위 next_page_token에, 과금액이 billing.charged_usd에 있습니다. 표에는 이 글에서 사용하는 필드만 정리했습니다. 각 이름은 카탈로그의 response_fields와 대조해 확인했습니다.
| 용도 | TikHub (App V2) | EveryInfra |
|---|---|---|
| 페이지네이션 | 검색: page + search_id + search_session_id. 댓글: cursor + index + pageArea | 직전 응답의 next_page_token에서 가져온 page_token 하나 |
| 노트 지정 | note_id 또는 share_text(공유 링크) | url(xsec_token이 포함된 노트 링크, 검색 결과 URL은 그대로 사용 가능) |
| 정렬 | sort_type(값 6개), 댓글은 sort_strategy | sort(검색은 값 5개, 댓글 값은 카탈로그 참고) |
| 좋아요, 저장, 댓글 수 | interact_info.liked_count 등 | like_count, collect_count, comment_count, share_count |
| 작성자 | user.user_id, user.nickname | author_id, author_name, author_red_id |
| 해당 호출의 비용 | 응답에 없음, 사용 로그에서 확인(로스앤젤레스 시간) | billing.charged_usd |
TikHub 방식의 파라미터를 실수로 그대로 보내면 422를 반환하고 무엇을 보내야 하는지 알려 드립니다. 테스트 4에서 확인했듯이 이 경우 과금되지 않습니다. 모든 Xiaohongshu 기능의 파라미터와 필드는 Xiaohongshu 플랫폼 페이지에서 확인하십시오.
약관과 법률: 플랫폼, 규제 당국, 법원의 입장
이 섹션은 데이터 수집 방식과 공개된 문서만 다루며, 법률 자문이 아닙니다. Xiaohongshu는 중국 본토 외 사용자를 위한 별도의 rednote 이용약관을 두고 있습니다. 중국어 사용자 약관은 2026년 3월 23일에 개정되었습니다. 제3.4조는 누구도 서면 허가 없이 플랫폼 콘텐츠나 데이터를 복제, 열람, 이용하거나 취합할 수 없다고 규정합니다. 제4.1조는 동영상, 게시물, 사용자 데이터의 불법 스크래핑과 모의 다운로드를 금지 행위로 명시합니다.
Xiaohongshu 오픈 플랫폼은 상점이 권한을 부여한 ERP, 주문 시스템, 자체 시스템을 위한 곳입니다. 2026년 10월 19일에는 카테고리 예측 API가 서비스 종료되고 이전된다는 공지를 올렸습니다. 노트와 댓글 콘텐츠는 오픈 플랫폼에서 제공하지 않으며, 이 때문에 서드파티 API가 존재합니다. Xiaohongshu API 선택 방법에 관한 글에서 세 가지 방식을 비교합니다.
댓글 데이터와 관련된 법률은 두 가지입니다. 개인정보보호법은 댓글 작성자 닉네임, IP 지역 등 개인정보 처리를 다룹니다. 네트워크 데이터 보안 관리 조례(국무원령 제790호)는 두 가지 규칙을 더합니다. 제18조는 자동화된 수집 시 네트워크 서비스에 미치는 영향을 평가해야 하며 정상적인 운영을 방해해서는 안 된다고 규정합니다.
제24조는 자동화 도구로 수집한 불필요한 개인정보를 삭제하거나 익명화해야 한다고 규정합니다. 따라서 어떤 API를 사용하든, 댓글을 받는 즉시 불필요한 닉네임과 사용자 ID를 삭제하는 것이 가장 간단한 조치입니다. 이 글의 모든 스크린샷과 수치에도 이 조치를 적용했습니다.
법원 판결은 두 가지 한계를 보여 줍니다. 2026년 4월 24일, 푸젠성 고급인민법원은 관련 사건을 공개했습니다(신화통신 보도, 중국어). 워터마크를 유지한 채 Xiaohongshu 게시물을 하나씩 내려받는 소프트웨어는 부정경쟁으로 인정되지 않았습니다. 반면 콘텐츠 재게시를 돕기 위해 동영상의 MD5 값을 변경한 소프트웨어는 부정경쟁으로 인정되었습니다. 창저우 법원이 공개한 2025년 형사 사건에서는 3명이 앱 암호화를 해독하고 요청을 위조해 사용자 데이터를 스크래핑한 뒤 대량 메시지를 발송했습니다. 이들은 컴퓨터 정보 시스템 불법 통제죄로 유죄 판결을 받았으며, 6.53백만 위안이 넘는 불법 수익이 몰수되었습니다.
두 사건 모두에서 법원이 위법으로 판단한 행위는 암호화 해독, 요청 위조, 타인 콘텐츠의 재게시 지원이었습니다.
TikHub가 더 나은 선택일 때
TikHub가 더 적합한 경우를 있는 그대로 정리했습니다. 표에는 각 경우의 이유와 저희가 대신 제공하는 것을 함께 적었습니다.
| 필요 사항 | TikHub가 적합한 이유 | 저희 쪽 |
|---|---|---|
| PGY 인플루언서 데이터: 오디언스 프로필, 팔로워 증가 추이, 마켓플레이스 필터, 키워드 지수 | 유료 pgy/ 엔드포인트 17개, 각 $0.02 | PGY 콘텐츠 랭킹만 제공 |
| 이미지 검색, 그룹 검색, 공개 저장 노트, 리뷰 개요, 상품 추천, 인스피레이션 피드, 검색어 추천 | 문서화된 App V2 및 Web V3 엔드포인트 | 저희 Xiaohongshu 카탈로그에 없음 |
| 높은 처리량 | 기본 초당 10건 | 기본 분당 60건 |
| 짧은 공유 링크만 있는 경우 | App V2는 xhslink.com의 share_text 지원 | xsec_token이 포함된 노트 URL 필요 |
| 다른 플랫폼에서 일일 요청량이 매우 많은 경우 | 일부 엔드포인트는 일일 구간별 0~50% 할인 | 기능별 정가 |
| 최저 단가로 인기 급상승 데이터 수집 | web_v3/fetch_hot_list, $0.001(작동하는 경우) | xiaohongshu/trending, $0.005556 |
이 중 두 행은 설명이 더 필요합니다. 짧은 공유 링크의 경우, 저희 노트 기능은 토큰이 이미 포함된 저희 검색 결과의 URL과 함께 쓸 때 가장 잘 작동합니다. 할인 행의 경우, FAQ에 따르면 할인은 누진 세율 구간처럼 적용됩니다. TikHub 요금 해설 글에서 두 서비스의 비용이 역전되는 지점을 계산했습니다. 유지 관리되는 Xiaohongshu 엔드포인트는 이 할인 대상이 아니므로 이 행은 다른 플랫폼에만 해당합니다.
이제 반대 경우입니다. 주로 Xiaohongshu 검색, 댓글, 계정별 노트 목록을 모니터링하는데 삭제되거나 만료된 링크를 자주 만난다고 가정해 보겠습니다. 또는 한 번의 요청으로 여러 노트의 댓글을 가져오고 싶거나, 결제 전에 무료로 테스트해 보고 싶을 수도 있습니다. 이 글의 수치로 보면 같은 데이터를 EveryInfra에서는 1.35~6.3배 저렴하게 이용할 수 있고, 실패하거나 빈 결과가 반환된 호출에는 비용이 들지 않습니다.
더 폭넓은 비교는 TikHub 대안 페이지를 참고하십시오.
2026년 9~11월 시장 동향
지난 두 달간 공개된 주요 소식 다섯 가지는 rednote 데이터 예산을 세우는 방식에 영향을 줍니다. 표에 정리했으며, 그중 가장 중요한 두 가지는 아래에서 설명합니다.
| 날짜 | 출처 | 발생 상황 | 예산에 미치는 영향 |
|---|---|---|---|
| 2026년 10월 9일 | China Daily | Red Land 페스티벌에 200,000명 이상이 방문했으며, Xiaohongshu는 게임에 관심 있는 월간 사용자가 120백만 명이라고 밝혔습니다 | 뷰티, 패션뿐 아니라 게임, 애니메이션 키워드도 집계 |
| 2026년 10월 12일 | Eastmoney / Southern Metropolis Daily | Xiaohongshu가 JD.com, Douyin보다 먼저 10월 10일 광군제 라이브 주간 시작 | 10월 중순부터 세일 시즌 요청량을 예산에 반영 |
| 2026년 10월 19일 | Xiaohongshu 오픈 플랫폼 | 카테고리 예측 API 서비스 종료 및 이전 | 공식 플랫폼은 상점용 API를 제공하며 시간이 지나면서 바뀜 |
| 2026년 10월 20일 | People's Daily Online | 10월 24일부터 베이징 서우강 공원에서 일주일간 도시 행사 개최 | 도시 행사도 노트 수를 늘림 |
| 2026년 10월 21일 | Jing Daily | #nicheshoes reached 1 billion impressions and luxury brands joined in | 트렌드 추적에는 토픽별 노트 필요 |
광군제 행이 저희 샘플 결과를 설명해 줍니다. "패딩 추천" 검색 결과 노트 40개 중 35개가 최근 30일 이내에 게시된 것이었습니다. 한산한 주를 기준으로 월 예산을 세우면 세일 시즌에 예산이 부족해집니다. 토픽 행은 도구 선택과 관련이 있습니다. TikHub의 토픽 엔드포인트는 문서 내용이 서로 맞지 않습니다(위 내용 참고). 저희는 xiaohongshu/hashtag로 토픽별 노트를 가져옵니다.
2026년 11월 1일부터 5일까지 TikHub 공개 요금표는 1,470행에서 1,472행으로 늘었고, Xiaohongshu는 95행 그대로였습니다. 같은 주에 오픈소스 프로젝트 xiaohongshu-mcp는 2026년 11월 4일(SGT)에 푸시가 있었고 스타 수는 16,895개였습니다. README에 따르면 먼저 본인의 Xiaohongshu 계정으로 로그인해야 합니다. 또한 한 계정으로 여러 웹 클라이언트에 동시에 로그인 상태를 유지할 수 없다고 나와 있습니다. 즉 오픈소스 도구는 비용을 줄여 주지만 본인 계정을 위험에 노출합니다. 유료 API는 계정이 필요 없지만, 각 엔드포인트가 여전히 유지 관리되고 있는지 확인해야 합니다.
한계: 이 결론이 성립하지 않는 경우
이 글의 비율은 아래와 같은 경우에 달라집니다. 표에는 각 가정과 그 가정이 성립하지 않을 때 결과가 어떻게 바뀌는지 정리했습니다.
| 가정 | 가정이 성립하지 않는 경우 | 영향 |
|---|---|---|
| TikHub는 페이지당 6~20행 반환(FAQ 기준 범위) | 매번 20행을 꽉 채워 반환하는 경우 | 검색 1.8배, 댓글 1.35배 차이 |
| 키워드 1개, 노트 1개, 계정 1개로 측정한 EveryInfra 페이지 크기 | 드문 키워드나 필터를 쓰면 페이지당 결과가 줄어듦 | EveryInfra의 1,000행당 비용 상승, 10행 댓글 페이지에서 최대 $0.556 |
| 지원 중단된 TikHub 엔드포인트는 응답하지 않음 | web/get_note_info_v5는 여전히 작동 | 노트 상세는 TikHub가 5.6배 저렴 |
| 2026년 11월 5일 확인한 가격 기준 | 어느 한쪽이 가격을 변경하는 경우 | 양쪽 가격표를 다시 확인 |
| 요금만 포함 | 대기 시간도 계산에 넣는 경우 | 마지막 단락 참고 |
이 글은 데이터 품질도 비교하지 않습니다. 필드 이름이 다르고, 같은 노트라도 필드 수가 다를 수 있습니다. 이번 테스트에서 EveryInfra의 노트 상세에는 값이 채워진 필드가 24개 있었습니다. 필드별로 비교할 실제 TikHub 응답은 확보하지 못했습니다. 따라서 필드가 같다거나 어느 한쪽이 더 완전하다고 주장하지 않습니다.
여기서 합계는 API 요금만 계산한 것이며 인건비나 대기 시간은 포함하지 않습니다. TikHub FAQ는 400 오류가 반복되면 30~60분 기다릴 것을 권합니다. EveryInfra에서는 429가 반환되면 retry_after초만큼 기다리면 됩니다. 어느 쪽 대기도 비용은 들지 않지만 작업 시간은 늘어납니다. 매일 오전 9시까지 보고서를 준비해야 한다면, 제공업체를 고르거나 요청 속도 부스트를 구매하기 전에 최악의 대기 시간을 고려해 계획하십시오.
FAQ
tikhub xiaohongshu login: TikHub를 쓰려면 Xiaohongshu 계정이 필요한가요?
TikHub FAQ의 "Do I have to give you my TikTok or Instagram login?" 항목에 따르면, 표준 엔드포인트에는 소셜 계정, 쿠키, 세션이 필요 없고 TikHub API 키만 있으면 됩니다. 일부 엔드포인트는 추가 세션 토큰이 필요하며, 해당 문서에 그렇게 명시되어 있습니다. EveryInfra도 마찬가지로 Xiaohongshu 기능에는 EveryInfra API 키만 있으면 됩니다. 두 서비스 모두 본인 계정으로 로그인해야 하는 오픈소스 xiaohongshu-mcp와는 다릅니다.
Reddit에서 찾는 Xiaohongshu API 대안: 무료 Xiaohongshu API가 있을까?
공식 오픈 플랫폼은 노트나 댓글 데이터를 제공하지 않습니다. TikHub는 회원가입 시 $0.05의 체험용 크레딧을 지급하지만, 유지 관리 중인 Xiaohongshu 엔드포인트에서는 이 크레딧을 사용할 수 없습니다. EveryInfra의 $1 GitHub 스타 체험용 크레딧으로는 24시간 안에 xiaohongshu/search를 약 179회 호출할 수 있습니다. 장기적으로 무료인 방법은 오픈소스뿐이며, 이 경우 본인 계정으로 로그인하고 서명 로직도 직접 유지 관리해야 합니다.
rednote api key: rednote 데이터용 키는 어떻게 받나요?
Xiaohongshu는 콘텐츠 데이터용 키를 일반에 발급하지 않습니다. 오픈 플랫폼이 승인된 쇼핑몰 시스템을 위한 것이기 때문입니다. TikHub에서는 회원가입 후 이메일을 인증하고 대시보드에서 키를 만듭니다. EveryInfra에서는 회원가입 후 콘솔에서 체험용 크레딧을 받고 키를 만듭니다. 자세한 단계는 빠른 시작에 있습니다. 두 경우 모두 키는 Xiaohongshu 키가 아니라 서드파티 키입니다.
Xiaohongshu 검색 API: 검색 호출 한 번에 결과가 몇 개 반환되나요?
이번 테스트에서 EveryInfra의 xiaohongshu/search는 두 페이지 모두 페이지당 20행을 반환했으며, 카탈로그에도 20으로 나와 있습니다. TikHub FAQ는 페이지네이션이 있는 Xiaohongshu 엔드포인트의 결과 수를 약 6~20개로 안내하며, 첫 페이지는 더 적을 수 있다고 설명합니다. 양쪽 모두 필터를 쓰면 결과 수가 줄 수 있으므로, 예산을 잡기 전에 사용할 키워드로 직접 측정해 보세요.
Xiaohongshu API 문서: 각 서비스의 문서는 어디에 있나요?
TikHub는 OpenAPI 파일과 docs.tikhub.io에서 Xiaohongshu 엔드포인트 45개를 문서화하고 있습니다. 가격이 책정된 나머지 50개 엔드포인트는 가격표에만 나옵니다. EveryInfra의 기능별 파라미터, enum 값, 응답 필드는 키 없이 볼 수 있는 카탈로그와 각 기능 페이지에 있습니다.
Xiaohongshu 스크래핑 API: 댓글을 가장 저렴하게 수집하는 방법은?
노트마다 첫 댓글 페이지만 필요하다면 요청당 노트를 최대 20개까지 처리하는 xiaohongshu/comments_batch를 사용하세요. 한 요청으로 묶어도 노트별로 과금됩니다. 노트 하나의 모든 댓글이 필요하다면 page_token을 사용해 xiaohongshu/comments를 페이지네이션하세요. 페이지당 15행이 반환됩니다. 일부 답글은 이미 인라인으로 포함되어 있고, 나머지는 xiaohongshu/sub_comments로 가져옵니다. id 기준으로 중복을 제거하세요. 테스트에서는 30행 중 1건이 중복이었습니다.
시작하기: 내 키워드로 계산을 다시 해보기
1단계: GitHub에서 everyinfra/everyinfra-agent-plugins와 everyinfra/seo-skills 저장소에 스타를 누릅니다. 회원가입 후 콘솔에서 $1 체험용 크레딧을 받고 API 키를 만듭니다. 자세한 내용은 빠른 시작에 있습니다. 2단계: 관심 있는 키워드로 위의 curl을 실행합니다. 응답의 count와 billing.charged_usd를 기록한 뒤 page_token으로 한 페이지를 더 가져옵니다. 3단계: 결과에서 노트 하나를 골라 그 url을 xiaohongshu/comments와 xiaohongshu/comments_batch에 한 번씩 전달합니다.
4단계: “총 과금액 ÷ 총 행 수 × 1,000”으로 직접 수치를 계산합니다. 이 값을 대응하는 TikHub 행과 비교합니다. TikHub 쪽 값은 $0.01 × 1,000 ÷ 페이지 크기를 올림한 값입니다. TikHub 단가는 공개 가격표 문서 페이지를 참고하세요. EveryInfra 카탈로그는 아래 명령으로 확인할 수 있습니다. 전체 기능과 체험용 크레딧은 데이터 마켓에 있습니다. 비슷한 Douyin 기능은 Douyin 플랫폼 페이지를 참고하세요.
# EveryInfra Xiaohongshu catalog (no key): unit price, page size and fields
curl -s "https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu" \
| jq -r '.capabilities[] | select(.platform=="xiaohongshu") | "\(.price_usd)\t\(.action)\t\(.page_size // "-")"'참고 자료
- TikHub, “Get all endpoints information” 공개 가격표 문서 페이지, 2026-11-05 00:13 SGT 확인, <https://docs.tikhub.io/186826055e0>
- TikHub, openapi.json (v5.3.2), 2026-11-05 확인, <https://api.tikhub.io/openapi.json>
- TikHub, “FAQ”(결제, 요청 속도 제한, 플랫폼 지원), 2026-11-05 확인, <https://tikhub.io/faq>
- TikHub, “Pricing”, 2026-11-05 확인, <https://tikhub.io/pricing>
- TikHub, “Rednote API” 페이지, 2026-11-05 확인, <https://tikhub.io/xiaohongshu-api>
- TikHub 블로그, Xiaohongshu API 가이드(중국어), <https://blog.tikhub.io/zh/article/7>
- TikHub, MCP 연동 페이지, <https://tikhub.io/mcp>
- TikHub, llms.txt, <https://tikhub.io/llms.txt>
- TikHub 문서, “Search notes (App V2)”, <https://docs.tikhub.io/420136398e0>
- TikHub 문서, “Get note comments (App V2)”, <https://docs.tikhub.io/420136394e0>
- TikHub 문서, “Get note sub-comments (App V2)”, <https://docs.tikhub.io/420748830e0>
- TikHub 문서, “Get user info (App V2)”, <https://docs.tikhub.io/420136395e0>
- TikHub 문서, “Get user posted notes (App V2)”, <https://docs.tikhub.io/420136396e0>
- TikHub 문서, “Get image note detail (App V2)”, <https://docs.tikhub.io/420136391e0>
- TikHub 문서, “Get video note detail (App V2)”, <https://docs.tikhub.io/420136392e0>
- TikHub 문서, “Search users (App V2)”, <https://docs.tikhub.io/420136399e0>
- TikHub 문서, “Search products (App V2)”, <https://docs.tikhub.io/420136401e0>
- TikHub 문서, “Get product detail (App V2)”, <https://docs.tikhub.io/420136403e0>
- TikHub 문서, “Get product reviews (App V2)”, <https://docs.tikhub.io/420136405e0>
- TikHub 문서, “Get topic feed (App V2)”, <https://docs.tikhub.io/420136408e0>
- TikHub 문서, “PGY note detail”, <https://docs.tikhub.io/479321007e0>
- TikHub 문서, “PGY creator detail”, <https://docs.tikhub.io/479321008e0>
- TikHub 문서, “PGY creator audience profile”, <https://docs.tikhub.io/479321014e0>
- TikHub 문서, “PGY creator marketplace”, <https://docs.tikhub.io/479321016e0>
- TikHub 문서, “PGY content square”, <https://docs.tikhub.io/505354737e0>
- TikHub 문서, “PGY keyword overview”, <https://docs.tikhub.io/505354738e0>
- TikHub 문서, “Get note detail (Web V3)”, <https://docs.tikhub.io/438852168e0>
- TikHub 문서, “Get search suggestions (Web V3)”, <https://docs.tikhub.io/438852174e0>
- TikHub 문서, “TikHub Refund Policy”, 2026-07-20 업데이트, <https://docs.tikhub.io/9453198m0>
- TikHub 문서 색인, llms.txt, <https://docs.tikhub.io/llms.txt>
- TikHub, GitHub 조직, <https://github.com/TikHub>
- EveryInfra, Xiaohongshu 기능 카탈로그, 2026-11-05 00:13 SGT 확인, <https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu>
- Model Context Protocol, “Specification (latest)”, <https://modelcontextprotocol.io/specification/latest>
- Xingin Information Technology (Shanghai), Xiaohongshu 사용자 이용약관(중국어), 2026-03-23 업데이트, <https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1>
- Xiaohongshu, “rednote Terms of Service”, <https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1>
- Xiaohongshu, 사용자 개인정보 처리방침(중국어), <https://agree.xiaohongshu.com/h5/terms/ZXXY20220509001/-1>
- Xiaohongshu 오픈 플랫폼, 홈페이지 및 공지(2026-10-19 카테고리 예측 API 서비스 종료), <https://open.xiaohongshu.com/>
- 전국인민대표대회 상무위원회, 개인정보보호법(중국어), <http://www.npc.gov.cn/npc/c30834/202108/a8c4e3672c74491a80b53a172bb753fe.shtml>
- 국무원, 네트워크 데이터 보안 관리 조례(국무원령 제790호), 생태환경부 전재(중국어), <https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml>
- Xinhua Fujian, 푸젠 법원이 Xiaohongshu 콘텐츠 스크래핑의 허용 범위를 제시(중국어), 2026-04-24, <http://fj.news.cn/20260424/93e71786d4b9436cb93a8383c8ebdba4/c.html>
- 창저우시 중급인민법원, "Scraping Xiaohongshu data for 6.5 million yuan, three sentenced"(중국어), 2025-03-24, <http://fy.changzhou.gov.cn/index.php?c=phone&a=show&id=13787&catid=40000>
- Eastmoney(Southern Metropolis Daily 기사 전재), Kuaishou와 Xiaohongshu에서 일찍 시작된 광군제(중국어), 2026-10-12, <https://finance.eastmoney.com/a/202610123893038013.html>
- China Daily, “Xiaohongshu's 'Red Land' ACGN festival draws a growing community of fans”, 2026-10-09, <https://www.chinadaily.com.cn/a/202610/09/WS6ac88df2e4b06d4aa0561e81.html>
- 인민망, 10월 24일부터 베이징 서우강 공원에서 열리는 Xiaohongshu 도시 행사(중국어), 2026-10-20, <http://finance.people.com.cn/n1/2026/1020/c1004-40818242.html>
- Jing Daily, “Weird shoes are 2026's Xiaohongshu viral opportunity”, 2026-10-21, <https://jingdaily.com/posts/weird-shoes-are-2026-s-xiaohongshu-viral-opportunity>
- xpzouying, xiaohongshu-mcp(GitHub 저장소 및 README, 2026-11-05 확인), <https://github.com/xpzouying/xiaohongshu-mcp>
참고 BL-93