Xiaohongshu API

Xiaohongshu search 파라미터는 각각 무엇을 의미하나요?

특정 주제의 Xiaohongshu 노트를 페이지당 20개씩 찾습니다. 제목, 본문 발췌, 좋아요·저장·댓글·공유 수, 작성자, 게시 시각을 가져옵니다. 콘텐츠 유형, 정렬, 날짜 범위로 좁힐 수 있습니다. 다음 페이지는 next_page_token을 page_token으로 다시 전달해 가져옵니다. 검색 결과 텍스트는 전체 노트가 아닌 발췌입니다.

keyword필수

search 액션에서 Xiaohongshu 노트 콘텐츠를 검색할 쿼리 문자열을 지정합니다(예: "sensitive skin sunscreen"). 사용자 ID가 아니라 노트 텍스트를 검색합니다.

content_type선택

반환할 노트를 이미지/텍스트, 동영상 등 콘텐츠 유형으로 필터링합니다. 현재 액션에 나열된 허용값을 사용하세요.

허용 값:allimagevideo

Xiaohongshu: 이미지·텍스트 노트와 동영상 노트의 진입점 — Xiaohongshu의 공개 딥링크 문서는 이미지·텍스트 노트, 동영상 노트, 노트 댓글 페이지를 따로 나열합니다. 이 참고 자료는 콘텐츠 유형 간 차이만 설명하며, 문서에 있는 앱 리디렉션 파라미터를 이 엔드포인트에 그대로 전달할 수는 없습니다. · 확인일 2026-09-04

date_range선택

게시 시간으로 노트를 필터링합니다: any_time(제한 없음, 생략과 동일), last_24_hours(최근 24시간), last_7_days(최근 7일), last_30_days(최근 1개월), last_6_months(최근 6개월), last_1_year(최근 1년). last_30_days와 last_1_year에서는 한 페이지의 노트가 20개보다 적을 수 있으며, 노트가 없는 페이지는 과금되지 않습니다. 페이지를 더 채우려면 sort=newest를 추가하세요. 이 두 값은 동기 호출에서만 동작합니다. 페이지를 넘기는 동안에는 같은 값을 유지하세요.

허용 값:any_timelast_1_yearlast_24_hourslast_30_dayslast_6_monthslast_7_days

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

sort선택

search 액션에서 노트 목록의 정렬 순서를 설정합니다: relevance, newest, most_liked, most_commented, most_collected. 해당 액션에 나열된 허용값만 사용하세요.

허용 값:most_collectedmost_commentedmost_likednewestrelevance

Xiaohongshu profile 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 계정을 조회합니다. 닉네임, Xiaohongshu ID, 소개, IP 위치, 인증 정보, 정확한 팔로워·팔로잉·게시물·좋아요·저장 수를 가져옵니다. /user/profile/ 링크의 ID, 링크 자체 또는 댓글 작성자의 author_id를 전달합니다. 표시되지 않는 수치는 0이 아니라 null로 반환됩니다.

user_id필수

profile 및 user_posts 액션에 사용할 Xiaohongshu 사용자 ID(URL에서 /user/profile/ 뒤에 오는 식별자) 또는 전체 프로필 URL을 지정합니다. 댓글 액션이 반환하는 author_id도 사용할 수 있습니다. 프로필 상세 정보나 게시한 노트를 가져오는 데 사용하며, 사용자 표시 이름은 받지 않습니다.

Xiaohongshu user_posts 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 크리에이터가 게시한 노트를 페이지당 20개씩 나열합니다. 고정된 노트가 먼저 나오고, 나머지는 최신순으로 이어집니다. 발췌, 각종 수치, 동영상 링크를 가져옵니다. 더 보려면 page_token을 사용합니다. 여기서 제공되는 링크에는 액세스 토큰이 없고, 텍스트는 발췌입니다. 브라우저에서 바로 열 수 있는 링크와 전체 본문은 note를 호출해야 합니다.

user_id필수

profile 및 user_posts 액션에 사용할 Xiaohongshu 사용자 ID(URL에서 /user/profile/ 뒤에 오는 식별자) 또는 전체 프로필 URL을 지정합니다. 댓글 액션이 반환하는 author_id도 사용할 수 있습니다. 프로필 상세 정보나 게시한 노트를 가져오는 데 사용하며, 사용자 표시 이름은 받지 않습니다.

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

Xiaohongshu note 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 노트 하나의 전체 내용을 읽습니다. 본문, 원래 순서대로 나열된 모든 이미지, 토픽, 언급된 사용자, 참여 수치, IP 위치를 가져옵니다. 이미지에 좌표가 있으면 좌표도 반환됩니다. xsec_token이 그대로 포함된 전체 노트 링크를 전달해야 합니다. 동영상 재생 링크와 댓글은 별도로 video와 comments를 호출해야 합니다.

url필수

/explore/<note_id> 또는 /discovery/item/<note_id> 형식의 전체 Xiaohongshu 노트 URL을 지정합니다. xsec_token 같은 쿼리 파라미터가 남아 있는 최근 검색 URL을 사용하세요. sub_comments 액션에는 이 url과 유효한 comment_id가 모두 필요합니다.

Xiaohongshu video 파라미터는 각각 무엇을 의미하나요?

note가 받는 것과 같은 URL로 Xiaohongshu 동영상 노트 하나의 재생 링크와 재생 시간을 가져옵니다. 서명된 링크는 만료되므로 빨리 다운로드해야 합니다. 이미지 노트는 빈 결과를 반환하며 환불됩니다.

url필수

/explore/<note_id> 또는 /discovery/item/<note_id> 형식의 전체 Xiaohongshu 노트 URL을 지정합니다. xsec_token 같은 쿼리 파라미터가 남아 있는 최근 검색 URL을 사용하세요. sub_comments 액션에는 이 url과 유효한 comment_id가 모두 필요합니다.

Xiaohongshu comments 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 노트의 최상위 댓글을 페이지당 15개씩 가져오며, 텍스트, 좋아요, IP 위치, 작성자, 답글 수, 노트 작성자 여부·AI 계정 여부 플래그가 포함됩니다. sort로 정렬하고 page_token으로 페이지를 넘기며, 답글 자체는 sub_comments로 읽습니다.

url필수

/explore/<note_id> 또는 /discovery/item/<note_id> 형식의 전체 Xiaohongshu 노트 URL을 지정합니다. xsec_token 같은 쿼리 파라미터가 남아 있는 최근 검색 URL을 사용하세요. sub_comments 액션에는 이 url과 유효한 comment_id가 모두 필요합니다.

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

sort선택

댓글 정렬: default는 플랫폼 자체 순서를 따르며 생략한 경우와 같고, newest는 최신 댓글을 먼저, most_liked는 좋아요가 많은 댓글을 먼저 보여 줍니다. 페이지를 넘기는 동안 같은 값을 유지해야 합니다. 값을 바꾸면 이전 next_page_token은 더 이상 적용되지 않습니다. default는 플랫폼의 추천 순서로 요청할 때마다 다시 정렬되므로, 순위가 바뀌면 페이지를 넘길 때 일부 댓글이 빠지거나 중복됩니다. newest는 게시 시각순이라 페이지 넘김이 안정적이지만, 일부 노트는 플랫폼이 최신 댓글 일부만 반환합니다. next_page_token이 없는 페이지는 플랫폼이 다음 페이지가 없다고 알렸다는 뜻일 뿐, 모든 댓글을 받았다는 뜻은 아닙니다. default로 처음부터 끝까지 여러 번 반복해서 넘긴 뒤 댓글 id로 합치면 빠진 댓글 일부를 보충할 수 있습니다.

허용 값:defaultmost_likednewest

Xiaohongshu comments_batch 파라미터는 각각 무엇을 의미하나요?

한 번의 호출로 Xiaohongshu 노트 1~20개의 댓글을 수집합니다. 각 행에는 note_id와 note_url이 있어 스레드가 구분됩니다. 모든 링크에는 유효한 노트 ID와 xsec_token이 있어야 합니다. 실패한 노트는 댓글이 0개인 것이 아니라 누락된 것으로 보고됩니다.

urls필수

comments_batch 액션에 사용할 Xiaohongshu 노트 URL 1~20개의 배열을 지정합니다. 각 URL에는 유효한 노트 ID와 xsec_token이 포함되어야 합니다. 과금은 대상 노트 단위이며, 일부 노트가 실패하면 댓글이 0개라고 단정하지 말고 partial 또는 missed 응답 필드를 확인하세요.

sort선택

요청의 모든 노트에 적용되는 댓글 정렬: default는 플랫폼 자체 순서를 따르며 생략한 경우와 같고, newest는 최신 댓글을 먼저, most_liked는 좋아요가 많은 댓글을 먼저 보여 줍니다.

허용 값:defaultmost_likednewest

Xiaohongshu sub_comments 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 노트의 댓글 하나에 달린 답글을 페이지당 10개씩 읽습니다. 텍스트, 좋아요, IP 위치, 각 답글의 대상을 가져옵니다. 노트 링크와 댓글 결과의 comment_id를 함께 전달합니다. 스레드를 재구성하려면 reply_to_id를 사용합니다.

url필수

/explore/<note_id> 또는 /discovery/item/<note_id> 형식의 전체 Xiaohongshu 노트 URL을 지정합니다. xsec_token 같은 쿼리 파라미터가 남아 있는 최근 검색 URL을 사용하세요. sub_comments 액션에는 이 url과 유효한 comment_id가 모두 필요합니다.

comment_id필수

sub_comments 액션에서 하위 답글을 가져올 상위 댓글 ID를 지정합니다. 같은 노트의 comments 응답에서 이 ID를 가져와 해당 url과 함께 전달하세요. 노트 ID나 사용자 ID가 아닙니다.

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

Xiaohongshu search_users 파라미터는 각각 무엇을 의미하나요?

키워드로 Xiaohongshu 크리에이터와 브랜드 계정을 페이지당 20개씩 찾습니다. 닉네임, Xiaohongshu ID, 팔로워 수, 인증 유형을 가져옵니다. follower_range나 user_type으로 필터링합니다. 팔로워 수는 목록에 표시된 반올림 수치에 근사한 값이므로, 정확한 수치는 profile을 호출해야 합니다.

keyword필수

계정을 찾을 키워드입니다(예: coffee, 브랜드 이름, 주제). 노트가 아닌 사용자(크리에이터와 브랜드 계정)를 반환합니다.

follower_range선택

search_users에서 팔로워 수로 계정을 필터링합니다: under_100, 100_to_1k, 1k_to_10k, 10k_to_100k, over_100k. 생략하면 제한이 없습니다.

허용 값:100_to_1k10k_to_100k1k_to_10kover_100kunder_100

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

user_type선택

search_users에서 유형으로 계정을 필터링합니다: general(일반 사용자), verified_individual(인증된 개인), business(인증된 기업). 생략하면 제한이 없습니다.

허용 값:businessgeneralverified_individual

Xiaohongshu hashtag 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu 토픽 페이지 하나에 있는 노트를 최신순 또는 인기순으로 둘러봅니다. 전체 텍스트, 모든 이미지, 참여 수치, 동영상 정보를 가져옵니다. 24자리 topic_id나 토픽 링크를 전달합니다. 페이지당 최대 20개의 노트가 담기며, next_page_token이 없을 때만 마지막 페이지입니다.

topic_id필수

hashtag에 사용할 토픽 페이지 ID(24자) 또는 https://www.xiaohongshu.com/page/topics/<ID> 같은 토픽 페이지 링크, 앱 토픽 링크, Xiaohongshu 단축 공유 링크입니다. note가 반환하는 topics[].topic_id 값을 그대로 사용할 수 있습니다. 노트 태그 객체의 ID나 토픽 이름이 아닙니다.

page_token선택

comments, sub_comments, search, user_posts, search_users, hashtag 액션의 페이지네이션 커서입니다. 다음 페이지를 가져오려면 이전 응답 행의 next_page_token 값을 다시 전달하고, 첫 페이지부터 시작하려면 생략하세요. 각 페이지는 호출 1건이며 요청당 과금됩니다.

sort선택

토픽 노트 정렬: newest는 최신 노트를 먼저 보여 주며 생략한 경우와 같고, popular는 인기 노트를 먼저 보여 줍니다. 페이지를 넘기는 동안 같은 값을 유지해야 합니다.

허용 값:newestpopular

Xiaohongshu trending 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu가 현재 추천하는 노트 샘플을 최대 30개까지 확인합니다. 각 노트에는 제목, 작성자, 이미지, 동영상 여부가 포함됩니다. 추천 목록은 불러올 때마다 바뀌며, 목록 순서만으로는 추천 알고리즘을 알 수 없고 추천 이력도 쌓이지 않습니다.

이 액션에는 비즈니스 파라미터가 없습니다. 플랫폼과 액션 식별자만 보내면 됩니다.

Xiaohongshu product_search 파라미터는 각각 무엇을 의미하나요?

keyword로 Xiaohongshu 스토어 상품을 검색합니다. 각 상품에는 제목, 가격, 정가, 통화, 판매량(페이지에 표시되는 경우), 재고 상태, 이미지, 스토어가 포함됩니다. 페이지당 보통 19개(관측된 범위는 18~20개)이며, next_page_token으로 페이지를 넘깁니다. 노트가 아닌 스토어 상품이며, 각 id는 product_detail에서 사용할 수 있습니다.

keyword필수

Xiaohongshu 스토어용 상품 검색어입니다(예: sunscreen). 노트가 아닌 상품(SKU)을 반환하며, 각 id는 product_detail의 product_id로 사용할 수 있습니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 한 페이지에는 보통 상품 19개가 담기며, 확인된 범위는 18~20개입니다. 페이지마다 호출 1건입니다. 스토어가 결과 순서를 바꾸기 때문에 인접한 페이지에 같은 상품이 몇 개 겹칠 수 있으므로 id로 중복을 제거해야 합니다. 토큰은 24시간 안에 사용해야 하며, 마지막 페이지에는 next_page_token이 없습니다.

Xiaohongshu product_detail 파라미터는 각각 무엇을 의미하나요?

24자리 ID나 상품 상세 링크로 Xiaohongshu 스토어 상품 하나를 읽습니다. 가격과 정가, 카테고리, 옵션, 재고, 판매량(페이지에 반올림된 수치가 표시되면 하한값), 대표 이미지와 상세 이미지, 상품 속성, 그리고 스토어의 평점(있는 경우), 총 판매량, 팔로워 수, 연결된 Xiaohongshu 계정을 가져옵니다.

product_id필수

product_search 행의 id에서 가져온 24자 상품 ID 또는 상품 링크 https://www.xiaohongshu.com/goods-detail/<ID>입니다. 형식이 잘못된 ID는 과금 전에 거부됩니다.

Xiaohongshu reviews 파라미터는 각각 무엇을 의미하나요?

24자리 product_id로 Xiaohongshu 스토어 상품의 구매자 리뷰를 기본순 또는 최신순으로 읽습니다. 각 리뷰에는 전체 텍스트, 5점 만점 평점, 서비스 및 배송 평점, 도움됨 투표 수, 답글 수, 구매자 사진, 리뷰 태그, 구매한 옵션, 리뷰 작성일이 포함됩니다. 리뷰 작성자 ID, 이름, 아바타는 반환되지 않습니다. 페이지당 최대 20개입니다.

product_id필수

product_search 행의 id에서 가져온 24자 상품 ID 또는 상품 링크 https://www.xiaohongshu.com/goods-detail/<ID>입니다. 형식이 잘못된 ID는 과금 전에 거부됩니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 최대 20개 리뷰가 담기며 페이지마다 호출 1건입니다. 마지막 페이지에는 next_page_token이 없습니다.

sort선택

리뷰 정렬: default는 스토어 기본 순위를 따르며 생략한 경우와 같고, newest는 최신순입니다. 페이지를 넘기는 동안 같은 값을 유지해야 합니다.

허용 값:defaultnewest

Xiaohongshu followers_list 파라미터는 각각 무엇을 의미하나요?

24자리 user_id나 프로필 링크로 Xiaohongshu 계정의 팔로워를 나열합니다. 각 팔로워에는 user_id, 닉네임, 아바타, 프로필 링크, 팔로워 수, 노트 수가 포함됩니다. 페이지당 보통 19~20명이며, next_page_token으로 페이지를 넘깁니다. 많은 계정이 팔로워 목록을 숨기며, 이 경우 호출이 실패하고 환불됩니다.

user_id필수

팔로워 목록을 조회할 사용자입니다. profile 또는 search_users가 반환하는 24자 user_id나 프로필 링크 https://www.xiaohongshu.com/user/profile/<ID>를 받습니다. 많은 계정이 팔로워 목록을 숨기며, 이 경우 호출이 실패하고 환불됩니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 한 페이지에는 보통 19~20명이 담기며 페이지마다 호출 1건입니다. 마지막 페이지에는 next_page_token이 없습니다.

Xiaohongshu note_location 파라미터는 각각 무엇을 의미하나요?

노트 링크나 공유 링크로 Xiaohongshu 노트에 태그된 장소 정보를 조회합니다. 표시된 그대로의 위치 텍스트, 도시, 장소 이름, 장소 ID를 가져옵니다. 태그된 장소가 없는 노트는 빈 결과를 반환합니다.

url필수

노트 링크(/explore/<note ID> 또는 /discovery/item/<note ID>) 또는 Xiaohongshu 공유 링크입니다. xsec_token 없이 노트 ID만 있으면 됩니다. 링크에 xsec_token이 있으면 반환되는 노트 링크에도 유지됩니다.

Xiaohongshu pgy_content_square 파라미터는 각각 무엇을 의미하나요?

Xiaohongshu의 브랜드–크리에이터 마켓플레이스인 Pugongying 콘텐츠 광장의 인기 콘텐츠 보드를 조회합니다. 전체 인기 노트, 제품 시딩, 이커머스 프로모션, 브랜드 협업, 리드 생성 등의 보드를 3~30일 기간으로 조회하거나, 키워드로 콘텐츠 광장을 검색할 수 있습니다(보드 및 기간 지정 불가). 각 노트에는 순위, 조회수, 좋아요 수, 저장 수, 댓글 수, 광고 여부, 작성자의 팔로워 수가 포함됩니다. 페이지당 20개씩, 보드당 최대 100행까지 제공됩니다.

board선택

pgy_content_square가 읽어 올 Pugongying 콘텐츠 스퀘어 보드입니다. hot(Xiaohongshu 인기, 기본값), product_seeding, ecommerce_promo, brand_collab, lead_gen, ecommerce_hot, seeding_direct 또는 app_promo 중에서 선택합니다. keyword를 지정하면 무시됩니다.

허용 값:app_promobrand_collabecommerce_hotecommerce_promohotlead_genproduct_seedingseeding_direct

keyword선택

선택: 콘텐츠 스퀘어의 노트를 이 키워드(예: coffee)로 검색합니다. 보드 전체를 가져오려면 생략하세요. 키워드 검색은 인기순으로 정렬되며 보드와 기간을 지원하지 않으므로(board와 time_window는 무시됨) 최근 한두 달 사이의 노트가 포함될 수 있습니다. 또한 키워드 검색 결과 행에는 like_count, comment_count, video_url, duration_sec, author_avatar_url이 없으며 링크에 액세스 토큰이 포함되지 않습니다.

page_token선택

페이지 토큰입니다. 첫 페이지에서는 생략하고, 이후에는 다른 파라미터를 바꾸지 않은 채 이전 응답의 next_page_token을 받은 그대로 전달합니다. 페이지당 노트 20개가 담기며 페이지마다 호출 1건입니다. 랭킹 하나에는 최대 100개(5페이지)가 담기고, 마지막 페이지에는 next_page_token이 없습니다.

time_window선택

pgy_content_square의 기간입니다. 3d, 7d(기본값), 14d 또는 30d 중에서 선택합니다. keyword를 지정하면 무시됩니다.

허용 값:14d30d3d7d