API Xiaohongshu
Читайте заметки, профили авторов и ветки комментариев по ключевым словам и URL постов, чтобы систематизировать исследование тем и обратную связь пользователей.
Для деталей и комментариев используйте URL заметок. Для комментариев нужен действительный xsec_token из недавних результатов поиска.
Доступность платформы
Сейчас не удаётся получить данные о доступности, поэтому недавнее состояние платформы неизвестно. Это не означает, что платформа недоступна.
Доступные возможности
Все действия Xiaohongshu: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите заметки Xiaohongshu по теме, по 20 на странице. | $5.56 за 1 000 запросов | — |
Профилиprofile | Найдите аккаунт Xiaohongshu. | $5.56 за 1 000 запросов | — |
Посты пользователяuser_posts | Получите заметки, опубликованные автором Xiaohongshu, по 20 на странице. | $5.56 за 1 000 запросов | — |
Сведения о заметкеnote | Читайте заметку Xiaohongshu целиком. | $5.56 за 1 000 запросов | — |
Сведения о видеоvideo | Получите ссылку на воспроизведение и длительность одной видеозаметки Xiaohongshu по тому же URL, который принимает note. | $5.56 за 1 000 запросов | — |
Комментарииcomments | Получите комментарии верхнего уровня к заметке Xiaohongshu, по 15 на странице, с текстом, лайками, IP-местоположением, комментатором, числом ответов и признаками автора заметки или ИИ-аккаунта. | $5.56 за 1 000 запросов | — |
Комментарии по нескольким URLcomments_batch | Собирайте комментарии к 1–20 заметкам Xiaohongshu за один вызов. | $5.56 за 1 000 запросов | — |
Ответы на комментарииsub_comments | Читайте ответы на один комментарий к заметке Xiaohongshu, по 10 на странице. | $5.56 за 1 000 запросов | — |
Поиск пользователейsearch_users | Находите авторов и аккаунты брендов Xiaohongshu по ключевому слову, по 20 на странице. | $5.56 за 1 000 запросов | — |
Хештегhashtag | Просматривайте заметки на странице одной темы Xiaohongshu, сначала новые или самые популярные. | $5.56 за 1 000 запросов | — |
Трендыtrending | Посмотрите выборку из не более чем 30 заметок, которые Xiaohongshu рекомендует прямо сейчас. | $5.56 за 1 000 запросов | — |
Поиск товаровproduct_search | Ищите товары в магазине Xiaohongshu по keyword. | $5.56 за 1 000 запросов | — |
Сведения о товареproduct_detail | Получите товар из магазина Xiaohongshu по 24-символьному ID или ссылке на страницу товара. | $5.56 за 1 000 запросов | — |
Отзывыreviews | Читайте отзывы покупателей о товаре магазина Xiaohongshu по 24-символьному product_id, в порядке по умолчанию или сначала новые. | $5.56 за 1 000 запросов | — |
Список подписчиковfollowers_list | Получите подписчиков аккаунта Xiaohongshu по 24-символьному user_id или ссылке на профиль. | $5.56 за 1 000 запросов | — |
Геолокация заметкиnote_location | Узнайте место, отмеченное в заметке Xiaohongshu, по ссылке на заметку или ссылке «Поделиться». | $5.56 за 1 000 запросов | — |
Контентные рейтинги Pugongyingpgy_content_square | Получайте рейтинги популярного контента из раздела «Контент-площадка» в Pugongying, маркетплейсе Xiaohongshu для сотрудничества брендов и блогеров: общий рейтинг популярных заметок, посев товаров, продвижение в e-commerce, коллаборации с брендами, лидогенерация и другие рейтинги за период от 3 до 30 дней. | $16 за 1 000 запросов | — |
Данные о состоянии этого API временно недоступны, поэтому неизвестно, как он работал в последнее время. Это не значит, что API не работает.
Какие параметры принимает каждое действие API Xiaohongshu?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите заметки Xiaohongshu по теме, по 20 на странице. Получите заголовок, фрагмент текста, число лайков, сохранений, комментариев и репостов, автора и время публикации. Фильтруйте результаты по типу контента и диапазону дат, а также задавайте порядок сортировки. Для следующей страницы передайте | keyword | content_type, date_range, page_token, sort | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · poi_id · poi_name · images · is_goods_note · is_cooperation_note · author_is_verified · updated_at · author_red_id · video_width · video_height |
profileПрофили Найдите аккаунт Xiaohongshu. Получите никнейм, Xiaohongshu ID, био, IP-местоположение, статус верификации и точное число подписчиков, подписок, постов, лайков и сохранений. Передайте ID из ссылки /user/profile/, саму ссылку или | user_id | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | user_id · nickname · red_id · url · bio · follower_count · following_count · like_collect_count · post_count · gender · ip_location · avatar_url · is_verified · tags · like_count · collect_count · real_name_info · verification_type · verification_text · location · platform |
user_postsПосты пользователя Получите заметки, опубликованные автором Xiaohongshu, по 20 на странице. Сначала идут закреплённые заметки, затем остальные от новых к старым. Получите фрагмент текста, счётчики и ссылки на видео. Для следующих страниц используйте | user_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images · is_goods_note · is_pinned · ip_location |
noteСведения о заметке Читайте заметку Xiaohongshu целиком. Получите текст, все изображения по порядку, темы, упомянутых пользователей, счётчики вовлечённости и IP-местоположение. Координаты возвращаются, если они есть в изображениях. Передайте полную ссылку на заметку с неизменённым xsec_token. Для ссылки на воспроизведение видео и комментариев нужны отдельные вызовы | url | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · ip_location · author_name · author_id · is_video · avatar_url · author_url · platform · images · tags · topics · mentioned_users · lat · lng · has_goods · is_cooperation_note · author_red_id · author_is_verified · language · updated_at |
videoСведения о видео Получите ссылку на воспроизведение и длительность одной видеозаметки Xiaohongshu по тому же URL, который принимает | url | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | id · url · video_url · duration_sec · duration_seconds · video_width · video_height · platform |
commentsКомментарии Получите комментарии верхнего уровня к заметке Xiaohongshu, по 15 на странице, с текстом, лайками, IP-местоположением, комментатором, числом ответов и признаками автора заметки или ИИ-аккаунта. Сортируйте через | url | page_token, sort | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 15. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · sub_comments · platform |
comments_batchКомментарии по нескольким URL Собирайте комментарии к 1–20 заметкам Xiaohongshu за один вызов. В каждой записи есть | urls | sort | Режим выдачи: Sync | Каждый вызов возвращает по одной странице комментариев к каждой заметке (максимум 15) без next_page_token; чтобы читать дальше, листайте комментарии каждой заметки по отдельности через comments. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · sub_comments · platform |
sub_commentsОтветы на комментарии Читайте ответы на один комментарий к заметке Xiaohongshu, по 10 на странице. Получите текст, лайки, IP-местоположение и адресата каждого ответа. Передайте ссылку на заметку и | url, comment_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 10. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · text · like_count · posted_at · ip_location · author_name · author_id · reply_to_id · reply_to_author_name · reply_to_author_id · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · platform |
search_usersПоиск пользователей Находите авторов и аккаунты брендов Xiaohongshu по ключевому слову, по 20 на странице. Получите никнейм, Xiaohongshu ID, число подписчиков и тип верификации. Фильтруйте по | keyword | follower_range, page_token, user_type | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | user_id · nickname · red_id · avatar_url · url · follower_count · is_verified · verification_type · next_page_token · platform |
hashtagХештег Просматривайте заметки на странице одной темы Xiaohongshu, сначала новые или самые популярные. Получите полный текст, все изображения, счётчики вовлечённости и данные видео. Передайте 24-символьный | topic_id | page_token, sort | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images |
trendingТренды Посмотрите выборку из не более чем 30 заметок, которые Xiaohongshu рекомендует прямо сейчас. Для каждой заметки возвращаются заголовок, автор, изображение и признак видео. Подборка меняется при каждой загрузке. Позиция в списке не позволяет судить об алгоритме или восстановить историю рекомендаций. | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $5.56 за 1 000 запросов | id · url · title · author_name · is_video · image_url · platform | |
product_searchПоиск товаров Ищите товары в магазине Xiaohongshu по | keyword | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · title · url · price · original_price · currency · image_url · sold_count · in_stock · shop_id · shop_name · next_page_token · platform |
product_detailСведения о товаре Получите товар из магазина Xiaohongshu по 24-символьному ID или ссылке на страницу товара. Вы получите цену и цену без скидки, категорию, вариант, остаток, число продаж (нижнюю границу, если страница показывает округлённое значение), основные и детальные изображения, характеристики товара, а также рейтинг магазина, если он есть, общий объём продаж, число подписчиков и связанный аккаунт Xiaohongshu. | product_id | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | id · title · url · price · original_price · currency · in_stock · category · sold_count · variant_name · image_urls · detail_image_urls · attributes · shop_id · shop_name · shop_rating · shop_sold_count · shop_user_id · shop_follower_count · platform |
reviewsОтзывы Читайте отзывы покупателей о товаре магазина Xiaohongshu по 24-символьному | product_id | page_token, sort | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | id · product_id · text · rating · rating_scale · service_rating · logistics_rating · like_count · reply_count · images · tags · sku · posted_date · next_page_token · platform |
followers_listСписок подписчиков Получите подписчиков аккаунта Xiaohongshu по 24-символьному | user_id | page_token | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет. | $5.56 за 1 000 запросов | user_id · nickname · avatar_url · url · follower_count · note_count · of_user · next_page_token · platform |
note_locationГеолокация заметки Узнайте место, отмеченное в заметке Xiaohongshu, по ссылке на заметку или ссылке «Поделиться». Получите текст местоположения в том виде, в каком он показан, город, название места и ID мест. Для заметки без отмеченного места возвращается пустой результат. | url | — | Режим выдачи: Sync | — | $5.56 за 1 000 запросов | note_id · url · location_text · city · poi_name · poi_ids · platform |
pgy_content_squareКонтентные рейтинги Pugongying Получайте рейтинги популярного контента из раздела «Контент-площадка» в Pugongying, маркетплейсе Xiaohongshu для сотрудничества брендов и блогеров: общий рейтинг популярных заметок, посев товаров, продвижение в e-commerce, коллаборации с брендами, лидогенерация и другие рейтинги за период от 3 до 30 дней. Также можно искать по контент-площадке по ключевому слову, без рейтингов и временных окон. Для каждой заметки возвращаются позиция в рейтинге, число прочтений, лайков, сохранений и комментариев, признак рекламы и число подписчиков автора. На странице возвращается 20 записей; в каждом рейтинге доступно не более 100 записей. | board, keyword, page_token, time_window | Режим выдачи: Sync | Каждый вызов возвращает одну страницу; максимум записей на странице — 20. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token. Параметр limit принимается, но ни на что не влияет. | $16 за 1 000 запросов | rank · id · url · title · is_video · like_count · collect_count · comment_count · view_count · posted_at · images · video_url · duration_sec · duration_seconds · is_ad · author_id · author_name · author_avatar_url · author_follower_count · platform |
Что означают параметры действия search в API Xiaohongshu?
Находите заметки Xiaohongshu по теме, по 20 на странице. Получите заголовок, фрагмент текста, число лайков, сохранений, комментариев и репостов, автора и время публикации. Фильтруйте результаты по типу контента и диапазону дат, а также задавайте порядок сортировки. Для следующей страницы передайте next_page_token обратно как page_token. Текст в поиске — фрагмент, а не полная заметка.
keywordОбязательный- Строка запроса для поиска по содержимому заметок Xiaohongshu (например, «sensitive skin sunscreen») в действии search. Ищет по тексту заметок, а не по ID пользователей.
content_typeНеобязательный- Фильтрует возвращаемые заметки по типу контента, например изображения с текстом или видео. Используйте допустимые значения, указанные для текущего действия.Допустимые значения:
allimagevideoXiaohongshu: точки входа для заметок с изображениями и видеозаметок — Публичная документация Xiaohongshu по диплинкам отдельно описывает заметки с изображениями и текстом, видеозаметки и страницы комментариев к заметкам. Этот источник приводится только для различения типов контента; параметры перехода в приложение из документации нельзя напрямую передавать в этот эндпоинт. · Проверено date_rangeНеобязательный- Фильтрует заметки по времени публикации: any_time (без ограничения, то же, что без параметра), last_24_hours (последние 24 часа), last_7_days (последние 7 дней), last_30_days (последний месяц), last_6_months (последние полгода) или last_1_year (последний год). С 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 из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
sortНеобязательный- Задаёт порядок заметок в результатах действия search: relevance, newest, most_liked, most_commented или most_collected. Используйте только допустимые значения, указанные для этого действия.Допустимые значения:
most_collectedmost_commentedmost_likednewestrelevance
Что означают параметры действия profile в API Xiaohongshu?
Найдите аккаунт Xiaohongshu. Получите никнейм, Xiaohongshu ID, био, IP-местоположение, статус верификации и точное число подписчиков, подписок, постов, лайков и сохранений. Передайте ID из ссылки /user/profile/, саму ссылку или author_id комментатора. Скрытые счётчики возвращаются как null, а не как ноль.
user_idОбязательный- ID пользователя Xiaohongshu (идентификатор после /user/profile/ в URL) или полный URL профиля для действий profile и user_posts. Подойдёт и author_id из действий с комментариями. Используется для получения сведений профиля или опубликованных заметок; отображаемые имена пользователей не принимаются.
Что означают параметры действия user_posts в API Xiaohongshu?
Получите заметки, опубликованные автором Xiaohongshu, по 20 на странице. Сначала идут закреплённые заметки, затем остальные от новых к старым. Получите фрагмент текста, счётчики и ссылки на видео. Для следующих страниц используйте page_token. Ссылки здесь не содержат токена доступа, а текст сокращён. Чтобы получить ссылку, готовую для открытия в браузере, и полный текст, вызовите note.
user_idОбязательный- ID пользователя Xiaohongshu (идентификатор после /user/profile/ в URL) или полный URL профиля для действий profile и user_posts. Подойдёт и author_id из действий с комментариями. Используется для получения сведений профиля или опубликованных заметок; отображаемые имена пользователей не принимаются.
page_tokenНеобязательный- Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
Что означают параметры действия note в API Xiaohongshu?
Читайте заметку Xiaohongshu целиком. Получите текст, все изображения по порядку, темы, упомянутых пользователей, счётчики вовлечённости и IP-местоположение. Координаты возвращаются, если они есть в изображениях. Передайте полную ссылку на заметку с неизменённым xsec_token. Для ссылки на воспроизведение видео и комментариев нужны отдельные вызовы video и comments.
urlОбязательный- Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token. Для действия sub_comments нужны и этот url, и действительный comment_id.
Что означают параметры действия video в API Xiaohongshu?
Получите ссылку на воспроизведение и длительность одной видеозаметки Xiaohongshu по тому же URL, который принимает note. Срок действия подписанной ссылки ограничен, поэтому скачайте видео как можно скорее. Если это заметка с изображениями, вернётся пустой результат, а средства будут возвращены.
urlОбязательный- Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token. Для действия sub_comments нужны и этот url, и действительный comment_id.
Что означают параметры действия comments в API Xiaohongshu?
Получите комментарии верхнего уровня к заметке Xiaohongshu, по 15 на странице, с текстом, лайками, IP-местоположением, комментатором, числом ответов и признаками автора заметки или ИИ-аккаунта. Сортируйте через sort, листайте через page_token, а сами ответы читайте через sub_comments.
urlОбязательный- Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token. Для действия sub_comments нужны и этот url, и действительный comment_id.
page_tokenНеобязательный- Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
sortНеобязательный- Порядок комментариев: default сохраняет порядок платформы (как и без параметра), newest ставит первыми новые комментарии, а most_liked ставит первыми комментарии с наибольшим числом лайков. При пагинации не меняйте значение: при другом значении прежний next_page_token больше не действует. default — это рекомендуемый порядок платформы, он пересчитывается при каждом запросе, поэтому при смене ранжирования пагинация пропускает или повторяет часть комментариев; newest упорядочивает по времени, и пагинация по нему стабильна, хотя для некоторых заметок платформа отдаёт только самую свежую часть. Страница без next_page_token означает лишь, что платформа сообщила об отсутствии следующей страницы, а не что получены все комментарии. С default несколько полных проходов по всем страницам с начала и объединение по id комментария возвращают часть пропущенных.Допустимые значения:
defaultmost_likednewest
Что означают параметры действия comments_batch в API Xiaohongshu?
Собирайте комментарии к 1–20 заметкам Xiaohongshu за один вызов. В каждой записи есть note_id и note_url, поэтому ветки не смешиваются. Каждая ссылка должна содержать корректный ID заметки и xsec_token. Заметка, которую не удалось обработать, помечается как пропущенная, а не как заметка без комментариев.
urlsОбязательный- Массив из 1–20 URL заметок Xiaohongshu для действия comments_batch. Каждый URL должен содержать действительный ID заметки и xsec_token. Оплата взимается за каждую указанную заметку; если некоторые заметки обработать не удалось, проверьте поля ответа partial и missed, а не считайте, что у них нет комментариев.
sortНеобязательный- Порядок комментариев для каждой заметки в запросе: default сохраняет порядок платформы (как и без параметра), newest ставит первыми новые комментарии, а most_liked ставит первыми комментарии с наибольшим числом лайков.Допустимые значения:
defaultmost_likednewest
Что означают параметры действия sub_comments в API Xiaohongshu?
Читайте ответы на один комментарий к заметке Xiaohongshu, по 10 на странице. Получите текст, лайки, IP-местоположение и адресата каждого ответа. Передайте ссылку на заметку и comment_id из результатов комментариев. Чтобы восстановить ветку, используйте reply_to_id.
urlОбязательный- Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token. Для действия sub_comments нужны и этот url, и действительный comment_id.
comment_idОбязательный- ID родительского комментария, ответы на который нужно получить в действии sub_comments. Берётся из ответа comments для той же заметки и указывается вместе с соответствующим url. Это не ID заметки и не ID пользователя.
page_tokenНеобязательный- Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
Что означают параметры действия search_users в API Xiaohongshu?
Находите авторов и аккаунты брендов 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 из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
user_typeНеобязательный- Фильтрует аккаунты в search_users по типу: general (обычный пользователь), verified_individual (верифицированный человек) или business (верифицированная компания). Без параметра ограничения нет.Допустимые значения:
businessgeneralverified_individual
Что означают параметры действия hashtag в API Xiaohongshu?
Просматривайте заметки на странице одной темы Xiaohongshu, сначала новые или самые популярные. Получите полный текст, все изображения, счётчики вовлечённости и данные видео. Передайте 24-символьный topic_id или ссылку на тему. На странице до 20 заметок, а конец списка обозначает только отсутствие next_page_token.
topic_idОбязательный- ID страницы темы для hashtag (24 символа) или ссылка на страницу темы, например https://www.xiaohongshu.com/page/topics/<ID>, ссылка на тему в приложении или короткая ссылка «Поделиться» Xiaohongshu. Значения topics[].topic_id из note подходят напрямую. Это не ID объекта тега в заметке и не название темы.
page_tokenНеобязательный- Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
sortНеобязательный- Порядок заметок темы: newest ставит первыми новые (как и без параметра), а popular ставит первыми самые популярные. При пагинации не меняйте значение.Допустимые значения:
newestpopular
Что означают параметры действия trending в API Xiaohongshu?
Посмотрите выборку из не более чем 30 заметок, которые Xiaohongshu рекомендует прямо сейчас. Для каждой заметки возвращаются заголовок, автор, изображение и признак видео. Подборка меняется при каждой загрузке. Позиция в списке не позволяет судить об алгоритме или восстановить историю рекомендаций.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеУ этого действия нет бизнес-параметров. Передайте только идентификаторы платформы и действия.
Что означают параметры действия product_search в API Xiaohongshu?
Ищите товары в магазине Xiaohongshu по keyword. Для каждого товара возвращаются название, цена, цена без скидки, валюта, число продаж, если страница его показывает, наличие, изображение и магазин. На странице обычно 19 товаров (встречалось от 18 до 20); для следующих страниц используйте next_page_token. Это товары магазина, а не заметки, и каждый id подходит для product_detail.
keywordОбязательный- Поисковый запрос по товарам магазина Xiaohongshu, например
sunscreen. Возвращает товары (SKU), а не заметки; каждыйidможно передать какproduct_idвproduct_detail. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Страница обычно содержит 19 товаров (встречалось от 18 до 20) и соответствует одному вызову. Магазин меняет порядок результатов, поэтому на соседних страницах могут повторяться несколько товаров; удаляйте дубликаты поid. Используйте токен в течение 24 часов. На последней странице нетnext_page_token.
Что означают параметры действия product_detail в API Xiaohongshu?
Получите товар из магазина Xiaohongshu по 24-символьному ID или ссылке на страницу товара. Вы получите цену и цену без скидки, категорию, вариант, остаток, число продаж (нижнюю границу, если страница показывает округлённое значение), основные и детальные изображения, характеристики товара, а также рейтинг магазина, если он есть, общий объём продаж, число подписчиков и связанный аккаунт Xiaohongshu.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеproduct_idОбязательный- 24-символьный ID товара из поля
idзаписиproduct_searchили ссылка на товар https://www.xiaohongshu.com/goods-detail/<ID>. Некорректный ID отклоняется до списания средств.
Что означают параметры действия reviews в API Xiaohongshu?
Читайте отзывы покупателей о товаре магазина Xiaohongshu по 24-символьному product_id, в порядке по умолчанию или сначала новые. Для каждого отзыва возвращаются полный текст, оценка по 5-балльной шкале, оценки сервиса и доставки, голоса «полезно», число ответов, фото покупателя, теги отзыва, купленный вариант и дата отзыва. ID, имена и аватары авторов отзывов никогда не возвращаются. До 20 на странице.
product_idОбязательный- 24-символьный ID товара из поля
idзаписиproduct_searchили ссылка на товар https://www.xiaohongshu.com/goods-detail/<ID>. Некорректный ID отклоняется до списания средств. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Страница содержит до 20 отзывов и соответствует одному вызову. На последней странице нетnext_page_token. sortНеобязательный- Порядок отзывов:
default(ранжирование магазина по умолчанию, как и без параметра) илиnewest(сначала новые). При пагинации не меняйте значение.Допустимые значения:defaultnewest
Что означают параметры действия followers_list в API Xiaohongshu?
Получите подписчиков аккаунта Xiaohongshu по 24-символьному user_id или ссылке на профиль. Для каждого подписчика возвращаются user_id, никнейм, аватар, ссылка на профиль, число подписчиков и число заметок. На странице обычно 19–20 человек; для следующих страниц используйте next_page_token. Многие аккаунты скрывают список подписчиков, и тогда вызов завершается ошибкой, а средства возвращаются.
user_idОбязательный- Чьих подписчиков вывести: 24-символьный user_id, который возвращают
profileилиsearch_users, или ссылка на профиль https://www.xiaohongshu.com/user/profile/<ID>. Многие аккаунты скрывают список подписчиков; в этом случае вызов завершается ошибкой, и средства возвращаются. page_tokenНеобязательный- Токен страницы. Для первой страницы не передавайте его, затем передавайте
next_page_tokenиз предыдущего ответа без изменений, не меняя остальные параметры. Страница обычно содержит от 19 до 20 пользователей и соответствует одному вызову. На последней странице нетnext_page_token.
Что означают параметры действия note_location в API Xiaohongshu?
Узнайте место, отмеченное в заметке Xiaohongshu, по ссылке на заметку или ссылке «Поделиться». Получите текст местоположения в том виде, в каком он показан, город, название места и ID мест. Для заметки без отмеченного места возвращается пустой результат.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Ссылка на заметку (/explore/<ID заметки> или /discovery/item/<ID заметки>) или ссылка «Поделиться» Xiaohongshu. Нужен только ID заметки, xsec_token не требуется. Если он есть в ссылке, он сохраняется в возвращаемой ссылке на заметку.
Что означают параметры действия pgy_content_square в API Xiaohongshu?
Получайте рейтинги популярного контента из раздела «Контент-площадка» в Pugongying, маркетплейсе Xiaohongshu для сотрудничества брендов и блогеров: общий рейтинг популярных заметок, посев товаров, продвижение в e-commerce, коллаборации с брендами, лидогенерация и другие рейтинги за период от 3 до 30 дней. Также можно искать по контент-площадке по ключевому слову, без рейтингов и временных окон. Для каждой заметки возвращаются позиция в рейтинге, число прочтений, лайков, сохранений и комментариев, признак рекламы и число подписчиков автора. На странице возвращается 20 записей; в каждом рейтинге доступно не более 100 записей.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеboardНеобязательный- Какую подборку раздела «Контент-площадка» Pugongying читает
pgy_content_square: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 заметок и соответствует одному вызову. В рейтинге не более 100 заметок (5 страниц), на последней странице нетnext_page_token. time_windowНеобязательный- Период для
pgy_content_square:3d,7d(по умолчанию),14dили30d. Игнорируется, если заданkeyword.Допустимые значения:14d30d3d7d
Как использовать API Xiaohongshu
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Xiaohongshu
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Пакетный сбор комментариев Xiaohongshu: от списка заметок к проверяемым результатам
Пошаговая интеграция comments_batch для Xiaohongshu: подготовка полных URL заметок, различение числа URL и числа комментариев, выявление результатов с флагами partial и missed, дедупликация по заметкам, а также обработка пустых результатов, повторных попыток и списаний за каждую цель.
Читать статьюНе ограничивайтесь итоговыми значениями в анализе данных Xiaohongshu: используйте экспорт заметок и исторические снимки
Разбираем в экспорте автора накопительные и интервальные метрики, даты снимков, прирост добавлений в избранное, дедупликацию и пропущенные выборки, чтобы избежать искажений между периодами и заметками.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API Xiaohongshu
Какие данные можно получить через API Xiaohongshu?
Укажите в platform значение xiaohongshu. В текущем каталоге: поиск, профили, посты пользователя, сведения о заметке, сведения о видео и more. Эти названия действий соответствуют разным объектам или представлениям Xiaohongshu; это не взаимозаменяемые режимы поиска.
Есть ли у Xiaohongshu официальный API?
Официальные открытые платформы Xiaohongshu рассчитаны на продавцов, разработчиков ПО для e-commerce, разработчиков мини-программ и партнёров по распространению контента. E-commerce-платформа открывает данные о товарах, заказах, послепродажном обслуживании и логистике магазинов, авторизовавших приложение; в её опубликованной документации нет API для поиска заметок или чтения заметок и комментариев других пользователей.
Официальные источники: «Xiaohongshu e-commerce open platform: API permission packages» · «Xiaohongshu e-commerce open platform» · Проверено
Нужен ли аккаунт разработчика Xiaohongshu или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Xiaohongshu, запрашивать доступ к API Xiaohongshu или входить через аккаунт Xiaohongshu. Действия возвращают только публичные данные Xiaohongshu.
Сколько стоит Xiaohongshu API за 1 000 запросов?
От $5.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе Xiaohongshu?
Строка запроса для поиска по содержимому заметок Xiaohongshu (например, «sensitive skin sunscreen») в действии search. Ищет по тексту заметок, а не по ID пользователей. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Xiaohongshu?
Объявленная схема включает title, text, like_count и collect_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Xiaohongshu возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. comments_batch runs только синхронно: оно получает все возвращаемые данные (по каждой цели пакета или каждому SKU товара) в рамках одного вызова API, а запрос с "mode": "async" получает ошибку 422 до какого-либо списания. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.