100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
Back to blog

샤오홍슈 API로 노트·인플루언서·인기 검색어 모으기

··17 min read

샤오홍슈 노트 검색, 댓글, 인플루언서 프로필, 인기 검색어를 계정이나 VPN 없이 API 키 하나로 받아요. 엔드포인트마다 호출 예시와 크레딧 계산을 붙였어요.

샤오홍슈 API로 노트·인플루언서·인기 검색어 모으기

샤오홍슈 데이터는 SocialCrawl API 키 하나면 충분해요. 노트 검색, 노트 상세, 댓글, 인플루언서 프로필, 인플루언서의 노트, 인기 검색어까지 GET 엔드포인트 여섯 개예요. 샤오홍슈 계정도, 쿠키도, VPN도 필요 없어요.

샤오홍슈(小红书, 레드노트)는 검색해서 쓰는 사람이 많은 중국 SNS예요. ZDNet Korea에 실린 샤오홍슈 보도자료에 따르면 이용자의 70%가 검색을 쓰고 한 사람이 하루 평균 6번 검색한다고 해요. 샤오홍슈 마케팅 데이터도 키워드 검색에서 시작해 인플루언서로 좁혀 가는 게 자연스러워요. 이 글도 그 순서로 가요.

샤오홍슈 API로 어떤 데이터를 받을 수 있나요?

공개된 노트, 댓글, 인플루언서, 인기 검색어가 와요. 응답은 틱톡이나 인스타그램과 같은 post, comment, author 구조라서 쓰던 파서를 그대로 붙이면 돼요. 기본 주소는 https://www.socialcrawl.dev이고 인증은 x-api-key 헤더 하나예요.

엔드포인트돌려주는 것크레딧
/v1/xiaohongshu/search키워드에 맞는 노트와 짧은 요약행당 5
/v1/xiaohongshu/post노트 하나의 본문, 미디어, 반응 수5
/v1/xiaohongshu/post/comments노트의 최상위 댓글행당 5
/v1/xiaohongshu/profile팔로워, 팔로잉, 노트 수, 받은 좋아요5
/v1/xiaohongshu/profile/posts인플루언서의 노트 목록행당 5
/v1/xiaohongshu/trending인기 검색어 보드와 인기 수치행당 5

목록 호출의 limit은 1에서 20까지, 기본값은 10이에요. 크레딧은 돌려받은 행만큼만 나가요. 오류가 나면 환불돼요. 환불 기준은 크레딧 문서에, 파라미터 전체는 샤오홍슈 문서에 있어요.

돋보기가 비추는 사진 피드 타일 격자와 옆으로 확대된 노트 상세 패널, 샤오홍슈 키워드 검색 결과 일러스트

샤오홍슈 노트는 어떻게 검색하나요?

/v1/xiaohongshu/search에 query를 넘기면 돼요. 노트가 중국어로 쓰여 있으니 검색어도 중국어 간체로 넣어요. 한국 스킨케어 브랜드라면 韩国护肤처럼요.

bash
curl -G "https://www.socialcrawl.dev/v1/xiaohongshu/search" \
  --data-urlencode "query=韩国护肤" --data-urlencode "limit=3" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

행 하나는 이런 모양이에요. 쓸 필드만 남겼어요.

json
{
  "post": {
    "id": "<note_id>",
    "url": "https://www.xiaohongshu.com/explore/<note_id>",
    "content": { "text": "노트 요약", "media_urls": null },
    "engagement": { "views": null, "likes": 1194, "comments": 239, "shares": 0, "saves": 753 },
    "published_at": "2026-09-15T03:06:35.000Z",
    "ext": { "author_id": "<author_id>", "title": "노트 제목", "media_type": "image", "text_truncated": true }
  },
  "computed": { "engagement_rate": null, "language": "zh" }
}

이 행을 쓰기 전에 알아 둘 점이 네 가지예요.

  • 본문은 잘린 요약이에요. text_truncated가 true이면 노트 상세를 따로 불러야 전문이 와요.
  • 조회수는 늘 비어 있어요. 샤오홍슈가 조회수를 공개하지 않아 views가 null이에요. 조회수로 계산하는 computed.engagement_rate와 computed.estimated_reach도 null이에요. 좋아요, 댓글, 저장은 값이 오니 참여율은 이 세 값으로 직접 계산하세요.
  • 검색 행의 shares가 0이어도 믿지 마세요. 값이 없다는 뜻일 때가 있어서 공유 수는 노트 상세에서 읽어요.
  • 미디어가 늘 목록은 아니에요. 영상 노트의 media_urls는 URL 문자열 하나로 오기도 해서 개수를 세기 전에 타입을 확인해요.

정렬은 sort(relevance, latest, most_liked, most_commented, most_collected), 유형은 type(all, image, video), 기간은 published(all, day, week, half_year)로 좁혀요. 해시태그 전용 호출은 없으니 해시태그 단어를 검색어로 넣으세요. 다음 페이지는 pagination.next_cursor를 cursor로 넘기면 돼요.

노트 본문과 댓글은 어떻게 받나요?

검색 행의 URL이나 노트 id를 /v1/xiaohongshu/post에 넘기세요. 본문 전체, 이미지나 영상 링크, 실제 공유 수, IP 지역이 와요.

bash
curl "https://www.socialcrawl.dev/v1/xiaohongshu/post?url=https://www.xiaohongshu.com/explore/<note_id>" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

이때는 text_truncated가 false예요. 이미지를 내려받을 때는 샤오홍슈 이미지 서버가 Mozilla/5.0으로 시작하지 않는 User-Agent를 거부하니 브라우저 User-Agent를 보내세요.

댓글도 같은 노트 URL을 써요.

bash
curl "https://www.socialcrawl.dev/v1/xiaohongshu/post/comments?url=https://www.xiaohongshu.com/explore/<note_id>&limit=20" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

행마다 댓글 본문, engagement.likes, 답글 수 engagement.replies, 작성자의 지역 ext.ip_location이 와요. 최상위 댓글만 오고 답글 스레드는 펼쳐지지 않아요. sort는 relevance(기본), latest, most_liked예요. 체험단 노트에 어떤 반응이 달렸는지 볼 때 쓰기 좋아요.

인플루언서와 그 노트는 어떻게 찾나요?

/v1/xiaohongshu/profile에 프로필 URL이나 노트의 post.ext.author_id를 id로 넘기세요. 팔로워, 팔로잉, 노트 수, 받은 좋아요가 와서 후보끼리 바로 견줘 볼 수 있어요.

bash
curl "https://www.socialcrawl.dev/v1/xiaohongshu/profile?id=<author_id>" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

주의할 점이 둘 있어요.

  • 프로필에는 노트가 없어요. 같은 id로 /v1/xiaohongshu/profile/posts를 따로 불러요. 고정 노트는 post.flags.pinned로 표시되고 최신 노트보다 앞에 올 때도 있어요. 행은 검색처럼 잘린 요약이에요.
  • 샤오홍슈 아이디(小红书号)로는 조회되지 않아요. author.username으로 오지만 표시용이에요. 조회에는 사용자 id나 프로필 URL을 쓰세요.

프로필의 computed.engagement_rate는 누적으로 받은 좋아요를 팔로워 수로 나눈 값이에요. 이 값이 1을 넘으면 참여율로 볼 수 없어서 API가 null로 비우고 이유를 _warnings에 적어 둬요. 제대로 된 참여율은 최근 노트의 반응 수로 직접 계산해요.

맨 위 막대에 불꽃이 올라간 순위 막대 그래프, 샤오홍슈 인기 검색어 보드 순위 일러스트

샤오홍슈 인기 검색어는 어떻게 보나요?

/v1/xiaohongshu/trending이 지금 샤오홍슈에서 많이 검색되는 주제를 보여 줘요. 보드는 20개짜리 하나라 페이지가 없어요. limit을 낮추면 같은 보드의 위쪽 N개만 와요.

bash
curl "https://www.socialcrawl.dev/v1/xiaohongshu/trending?limit=10" \
  -H "x-api-key: $SOCIALCRAWL_API_KEY"

항목마다 rank, title(중국어), hot_value가 와요. 카테고리 필터는 없어요. 뷰티처럼 좁은 분야를 보려면 title이나 내 키워드를 검색 엔드포인트에 넣으세요.

파이썬으로 호출을 이어 붙이려면 어떻게 하나요?

키워드로 검색한 뒤 첫 노트의 본문, 댓글, 작성자까지 받아 오는 스크립트예요. 검색 결과가 없으면 거기서 멈춰요.

python
import os
import sys

import requests

BASE = "https://www.socialcrawl.dev/v1/xiaohongshu"
HEADERS = {"x-api-key": os.environ["SOCIALCRAWL_API_KEY"]}


def get(path, **params):
    r = requests.get(f"{BASE}/{path}", params=params, headers=HEADERS, timeout=60)
    if r.status_code == 404:
        return None
    r.raise_for_status()
    return r.json()


search = get("search", query="防晒", limit=3)
if not search or not search["data"]["items"]:
    sys.exit("No notes found")

first = search["data"]["items"][0]["post"]
note = get("post", url=first["url"])["data"]["post"]
author_id = note["ext"]["author_id"]

comments = get("post/comments", url=first["url"], limit=5)
profile = get("profile", id=author_id)["data"]["author"]
creator_notes = get("profile/posts", id=author_id, limit=5)

print(note["content"]["text"][:80], note["engagement"])
print(profile["followers"], profile["posts_count"])
print(len(comments["data"]["items"]), "comments")
print(len(creator_notes["data"]["items"]), "creator notes")

이 한도로 돌리면 검색 15, 노트 5, 댓글 25, 프로필 5, 인플루언서 노트 25로 최대 75크레딧이에요. 더 길게 수집한다면 SNS 크롤링을 참고하세요.

샤오홍슈에 공식 API가 있나요?

노트를 읽는 공식 API는 없어요. 샤오홍슈 오픈 플랫폼은 입점 셀러와 셀러용 도구를 만드는 개발사를 위한 곳이에요. API 목록도 주문, 애프터서비스, 상품, 재고, 물류, 정산을 다뤄요. 가게 운영용이라 노트, 검색 결과, 인기 검색어, 인플루언서 프로필을 읽는 용도가 아니에요. 푸궁잉(蒲公英, pgy.xiaohongshu.com)은 브랜드와 인플루언서 협업을 위한 샤오홍슈 공식 플랫폼이고 자체 콘솔에서 써요.

공식 API가 없다 보니 직접 만든 크롤러나 GitHub의 비공식 프로젝트를 찾게 돼요. 직접 만들면 샤오홍슈가 언제든 바꿀 요청 서명을 계속 따라가야 해요. 호스팅 API는 그 부담을 덜어 줘요. 선택지는 수집 API 비교에서 견줘 보세요.

샤오홍슈 API의 한계는 무엇인가요?

  • 조회수가 없어서 조회수 기반 참여율과 도달 추정은 null이에요.
  • 검색과 인플루언서 노트 행은 요약이에요. 전문은 노트 상세로 읽어요.
  • 댓글은 최상위만 와요.
  • 인기 검색어는 최대 20개이고 페이지가 없어요.
  • 공개 데이터만 다뤄요. 어디까지 쓸 수 있는지는 사용 목적에 따라 달라요. 저장하거나 재게시하기 전에 확인하세요.

틱톡 데이터가 필요하면 틱톡 영상 검색 API에 같은 호출 방식이 나와 있어요.

자주 묻는 질문

샤오홍슈 계정이나 VPN 없이도 되나요?

네, 돼요. SocialCrawl API 키만 있으면 로그인, 쿠키, VPN 없이 호출해요.

샤오홍슈 아이디로 인플루언서를 찾을 수 있나요?

아니요. 프로필 호출은 프로필 URL이나 노트에 붙은 사용자 id(author_id)로 조회해요. 샤오홍슈 아이디(小红书号)는 응답의 author.username으로 오지만 조회 키로는 못 써요.

레드노트와 샤오홍슈는 같은 앱인가요?

같은 서비스예요. 레드노트(RedNote)는 샤오홍슈(小红书)의 영문 이름이에요(Wikipedia).

해시태그로도 검색할 수 있나요?

해시태그 전용 엔드포인트는 없어요. 해시태그 단어를 검색 엔드포인트의 query에 넣어 찾아요.

조회수는 왜 비어 있나요?

샤오홍슈가 조회수를 공개하지 않아서 모든 행의 views가 null이에요. 좋아요, 댓글, 저장은 값이 오니 이 세 값으로 참여율을 직접 계산하세요.

비용은 얼마인가요?

모든 엔드포인트가 돌려받은 행당 5크레딧이에요. 노트 하나나 프로필 하나도 한 행이에요. limit=10으로 검색하면 최대 50크레딧이에요. 오류는 환불돼요. 크레딧 가격은 가격 페이지에서 확인하세요.

Topics
#샤오홍슈-api#샤오홍슈-마케팅#샤오홍슈-검색#샤오홍슈-인플루언서#중국-마케팅#샤오홍슈-체험단#레드노트#중국-트렌드

함께 읽으면 좋은 글

🤖 AI agent or LLM? Read this page as markdown