API Xiaohongshu: официальная платформа, скрипты с GitHub или оплата за вызов

Большинство тех, кто ищет «xiaohongshu api» или «rednote api», хотят получить публичные посты и комментарии чужих аккаунтов. На 4 ноября 2026 года официальная открытая платформа Xiaohongshu такого не предлагала. Её платформа для аккаунтов предоставляла только один набор прав, basic_info, с четырьмя полями: никнейм, аватар, пол и регион. Набор прав на чтение публикаций по-прежнему имеет статус «запланировано» (список наборов прав). Мы также проверили девять популярных парсеров с открытым исходным кодом на GitHub.

За последние 90 дней в них появилось 92 новых issue, и в 31 из них сообщается о сломанном входе, заблокированном запросе или изменении страницы. Затем мы оплатили девять реальных вызовов через EveryInfra. Каждый вызов стоил $0.005556. Одна страница поиска вернула 20 постов, то есть $0.278 за 1 000 постов. Пустые результаты и неверные параметры ничего не стоят.

В этой статье сравниваются три способа получить данные Xiaohongshu. Первый — официальная открытая платформа. Второй — скрипт с открытым исходным кодом, который работает после входа в ваш аккаунт. Третий — сторонний API данных с оплатой за каждый запрос.

Для первых двух способов мы использовали только публичные материалы: официальную документацию для разработчиков, публичные данные GitHub и общедоступные обращения в GitHub Issues. Для третьего способа мы использовали собственный API EveryInfra и приводим фактическую сумму списания, указанную в каждом ответе. Другие сторонние сервисы мы не называем. В разделе о сравнении цен сторонних сервисов есть формула, с помощью которой вы можете самостоятельно пересчитать любой прайс-лист.

Коротко: что может и чего не может каждый способ

Три способа — это не три цены за одно и то же. Они дают доступ к разным данным. Официальная платформа рассчитана на ваши собственные ресурсы: вход в ваше приложение, заказы вашего магазина и отчёты по вашей рекламе. В ней нет эндпоинта, который ищет чужие посты или читает чужие комментарии.

Скрипт с GitHub может прочитать почти всё, что вы видите в браузере, потому что работает как браузер, в котором выполнен вход в ваш аккаунт. Поэтому доступные данные и продолжительность работы зависят от вашего аккаунта и текущей версии сайта. API с оплатой за вызов превращает ту же задачу в обычный HTTP-запрос. Вы платите за каждый запрос, а доступные данные и число записей на странице соответствуют сведениям в публичном каталоге провайдера.

Первую строку часто упускают из виду. Распространённый план звучит так: «сначала подать заявку на официальный API, а искать другие варианты только при отказе». Но сегодня все области доступа, связанные с публичным контентом (user_profile, read_notes и read_followers), закрыты. Даже с одобренным приложением вы получаете никнейм и аватар пользователя, который входит в аккаунт. В следующих разделах разобран каждый способ, и для каждого утверждения приведён исходный текст или наши тестовые данные.

Есть ли официальный API Xiaohongshu? Четыре входа для четырёх задач

Да, и не один. Каждый из них закрывает свою задачу. 4 ноября 2026 года мы открыли все публичные сайты Xiaohongshu для разработчиков. Для каждого мы выписали аудиторию, условия доступа и данные, которые вы получаете.

Платформа аккаунтов — самый новый из входов. На её главной странице сказано, что она добавляет в ваше приложение вход через Xiaohongshu по стандартному протоколу OAuth 2.0 (портал разработчика). Согласно руководству, проверка нового приложения занимает около 1–3 рабочих дней. Там же указано, что сейчас открыта только область доступа basic_info (Быстрый старт). На странице областей доступа их перечислено пять.

Статус «открыто» есть только у basic_info. У остальных четырёх статус «запланировано», а для write_notes также указано, что нужна ручная проверка и доступ открывается только в особых случаях (список областей доступа). В справочнике API 11 эндпоинтов, и все они связаны с токенами и входом. Они проверяют статус, получают и обновляют токен, возвращают базовые данные пользователя, отзывают доступ и выполняют вход по QR-коду для экранов автомобилей и веб-страниц. Страница последний раз обновлялась 19 августа 2026 года, и срок жизни refresh-токена на ней указан как 180 дней (справочник API).

Открытая платформа электронной коммерции — вход, который знают владельцы магазинов. На ней две роли разработчиков. Разработчик ПО создаёт инструменты для заказов, товаров или ERP для многих магазинов Xiaohongshu и размещает приложение на маркетплейсе сервисов. Разработчик собственных решений создаёт инструменты только для своего магазина. Условия доступа строгие. Разработчик ПО должен быть компанией, зарегистрированной в континентальном Китае более года, в перечень видов деятельности которой входят техническая разработка или технические услуги.

Разработчиком собственных решений не может быть магазин физического лица (руководство по ролям разработчиков, сторонняя копия документации платформы). В руководстве по авторизации сказано, что авторизовать приложение может только основной аккаунт магазина. Код авторизации действует 10 минут, access-токен — 7 дней, refresh-токен — 14 дней (процесс авторизации для разработчиков ПО).

Все вызовы бизнес-API идут на один адрес шлюза. Каждый вызов содержит MD5-подпись, сформированную на основе appId, timestamp, version, method и секрета приложения (метод подписи). Этот вход связывает ваш магазин с вашими собственными системами. Граница данных — магазин, который вас авторизовал.

Правила для токенов показывают, насколько узок каждый вход. Мы свели опубликованные сроки действия в одну таблицу:

Третий вход — рекламный Marketing API. В руководстве по началу работы сказано, что API предназначен для ключевых отраслевых клиентов, которые уже размещают рекламу на платформе и имеют опыт работы с API. Регистрацию разработчика запускает менеджер по продажам платформы (начало работы с Marketing API). API даёт отчёты и управление кампаниями вашего рекламного аккаунта, но не органические посты.

Четвёртый вход — платформа для публикации в Xiaohongshu, которая позволяла другим приложениям делиться контентом одним касанием и быстро публиковать его (платформа для публикации). В ноябре 2025 года один разработчик написал, что на странице нет кнопки регистрации и указано, что регистрация приостановлена (пост на форуме). Когда мы открыли её 4 ноября 2026 года, возможности зарегистрироваться там по-прежнему не было. Есть также платформа мини-программ для приложений, которые работают внутри Xiaohongshu (платформа мини-программ), и она тоже не читает контент сообщества.

Чего не даёт официальная платформа

Если сложить четыре входа вместе, вывод простой. Официальные API обращены внутрь. Они охватывают ваш собственный аккаунт, ваш магазин и вашу рекламу. Ни в одном из четырёх входов не описан эндпоинт для работы с данными третьих лиц, через который можно искать по всем постам, читать любые комментарии или открывать любой публичный профиль. На странице областей доступа read_notes и read_followers всё ещё «запланированы».

Для читателей за пределами континентального Китая есть второй документ. Пользователи, зарегистрировавшиеся за пределами континентального Китая, — это пользователи RedNote. На них распространяются условия RedNote, действующие с 9 июня 2026 года; оператор — Rednote Technology Pte. Ltd. (RedNote Terms of Service). Что оба набора условий говорят об автоматическом чтении, разобрано ниже, в разделе о соответствии требованиям.

Поэтому на вопрос «rednote api» ответ такой же, как на вопрос «xiaohongshu api». Официального API для чтения публичного контента нет ни в одной из версий.

Так что за поисковым запросом «xiaohongshu api» скрываются две разные задачи. Если вам нужен вход в ваше приложение, подключение вашего магазина или отчёты вашего рекламного аккаунта, используйте официальный вход. Дальше можно не читать. Если вам нужны отслеживание конкурентов, мониторинг упоминаний бренда, исследование товаров или тренды контента, официальные входы сегодня не помогут. Остаётся скрипт или сторонний API.

Для обоих вариантов нужно чётко понимать правовые ограничения; о них ниже, в разделе о соответствии требованиям. Ещё спрашивают про API маркетплейса авторов. Один разработчик на китайском форуме написал, что к эндпоинтам его веб-страницы можно обращаться с файлом cookie своей сессии. Другой разработчик в той же ветке ответил, что так возвращаются только первые несколько отобранных комментариев, а пагинация не работает (ветка форума). Этот способ тоже обращается к эндпоинтам страницы от имени вашей учётной записи, поэтому относится к варианту со скриптами из следующего раздела.

Xiaohongshu API на GitHub: замеры девяти популярных репозиториев

Скрипты с открытым кодом — первый выбор многих разработчиков: они бесплатны, и код можно прочитать. Мы не хотели писать «скрипты часто ломаются» по памяти, поэтому 4 ноября 2026 года в 00:19:50 (по сингапурскому времени) сделали выборку на GitHub через GitHub API. Правило было простым. Мы искали на GitHub по запросам xiaohongshu, xhs spider и китайскому названию приложения. Для каждого запроса взяли первые 30 результатов по числу звёзд и убрали дубликаты.

Затем мы оставили только репозитории, основная задача которых — получение данных. Это краулеры, обёртки над запросами, MCP-серверы, инструменты командной строки и загрузчики. Мы исключили инструменты, которые только публикуют посты, создают изображения или скачивают видео с разных сайтов. Отбор прошли девять репозиториев. «Обращения за 90 дней» — это обращения, открытые с 6 августа по 4 ноября 2026 года, без учёта запросов на слияние (GitHub issues API).

Мы прочитали заголовок каждого обращения и вручную отнесли его к одной из четырёх групп. Первая группа — сбои при входе, ошибки файлов cookie, QR-кодов или сессий (10 обращений). Вторая — требования пройти проверку, ограничение поиска или блокировка запросов (3 обращения). Третья — сбои или тайм-ауты при чтении, парсинге или автоматизации после изменения страницы или эндпоинта (18 обращений).

Ещё 61 обращение относится к запросам на добавление функций, проблемам с установкой, уведомлениям о безопасности, рекламным постам или заголовкам без внятного содержания. Заголовки могут вводить в заблуждение. Например, у трёх обращений в заголовке было только слово «проблема», и мы отнесли их к группе «другое». Поэтому 31 — это нижняя граница.

Эти цифры не означают, что активные проекты плохие. Наоборот: у проекта много обращений, потому что им пользуется много людей, а мейнтейнер активно его развивает. В xiaohongshu-mcp было 35 коммитов за 30 дней. Среди недавних обращений — «не могу войти» (#880, 23 октября) и «поиск ограничен, хотя в мобильном приложении всё работает» (#877, 21 октября). Один пользователь прямо спросил, разрешает ли платформа использовать этот инструмент.

Тот же пользователь спросил, может ли инструмент снизить охват его собственных постов (#878, 22 октября). В обращении XHS-Downloader #497 (17 октября) показан типичный случай изменения страницы. Серверные данные на веб-странице начали использовать новый синтаксис, и парсер перестал работать. В том же репозитории в обращении #479 просят добавить настройку для снижения скорости сбора данных, чтобы не срабатывала защита сайта. Заголовок обращения Spider_XHS #191 (10 октября) предельно прост: «Файл cookie недействителен или срок его действия истёк».

Другой риск — проект, который никто не поддерживает. ReaJason/xhs — обёртка над запросами к веб-сайту Xiaohongshu. Последний коммит в нём был сделан 1 июля 2025 года, то есть 490 дней назад. xiaohongshu-cli перестал обновляться 21 марта 2026 года. Отсутствие новых обращений не означает, что код работает.

Возможно, пользователи просто ушли. Прежде чем выбрать скрипт для ежедневной задачи, проверьте три вещи. Посмотрите дату последнего коммита. Изучите обращения за последний месяц и поищите сообщения о проблемах со входом, истечении срока действия авторизации или ошибках парсинга. Оцените, как быстро отвечает мейнтейнер.

Реальные издержки использования скриптов: авторизация, подписи запросов, разделение аккаунтов Xiaohongshu и RedNote и лицензии

Первая издержка связана с авторизацией. Почти все популярные скрипты требуют войти в аккаунт и сохранить cookie. В README xiaohongshu-mcp жирным шрифтом сказано, что один аккаунт не может оставаться авторизованным одновременно в нескольких веб-клиентах. Если войти в другом веб-клиенте, инструмент выйдет из аккаунта. Автор также предупреждает, что при использовании нового аккаунта без подтверждения личности система запросит проверку (README xiaohongshu-mcp).

Пользователь xiaohongshu-cli пожаловался в #82, что инструмент требовал входить заново каждые 7 дней. Когда срок действия авторизации истекает, запланированная задача останавливается, и часто вы узнаёте об этом, только когда следующий отчёт оказывается пустым. Под угрозой и сам аккаунт. В разделе 2.3 пользовательского соглашения сказано, что аккаунтом может пользоваться только его владелец. Передача аккаунта третьему лицу не допускается, а платформа может заблокировать аккаунты, которые считает рискованными (пользовательское соглашение). Исходите из того, что аккаунт, под которым работает ваш скрипт, можно потерять в любой момент.

Вторая издержка — подпись запросов. Запросы к веб-эндпоинтам Xiaohongshu содержат заголовки подписи, например x-s и x-s-common. Некоторым эндпоинтам нужен ещё один заголовок антибот-защиты. Для этой задачи существуют целые репозитории. В README xhshow сказано, что он формирует заголовки x-s, x-s-common и x-rap-param. Там же уточняется, что эндпоинтам ленты, поиска и публикации нужен дополнительный заголовок x-rap-param (Cloxl/xhshow).

MediaCrawler действует иначе. Он сохраняет авторизацию в браузере под управлением Playwright и выполняет в нём JavaScript, чтобы получить значения подписи. В README сказано, что он подключается к уже установленному у пользователя Chrome, чтобы снизить риск обнаружения (README MediaCrawler). У обоих подходов одно слабое место. Когда меняется метод подписи, все зависящие от него скрипты перестают работать одновременно. Это одна из причин появления упомянутых выше 18 сообщений о поломках.

Третья издержка важнее всего для читателей за пределами Китая: разделение аккаунтов Xiaohongshu и RedNote. Оно описано в обращении #579 в xiaohongshu-mcp. Зарегистрировавшиеся после 8 декабря 2025 года по номеру телефона не из Китая относятся к пользователям RedNote. Их веб-сессии работают через rednote.com, а cookie используют домен .rednote.com.

Скрипты, которые работают только с cookie домена xiaohongshu.com, постоянно сообщают: «Вход не выполнен». Это согласуется с пользовательским соглашением, по которому для пользователей из континентального Китая и пользователей RedNote действуют два разных набора условий. Если ваша команда в Сингапуре, Лондоне или Нью-Йорке зарегистрировала аккаунты в 2026 году по местным номерам телефонов, многие руководства для неё не сработают.

Два типа аккаунтов подчиняются разным правилам. В таблице сведены факты из обращения и обоих наборов условий:

Четвёртая издержка — лицензия, и о ней многие забывают. MediaCrawler распространяется по лицензии «NON-COMMERCIAL LEARNING LICENSE 1.1». В ней сказано, что ПО предназначено только для обучения и исследований. Его нельзя использовать для масштабного сбора данных или для нарушения работы платформы. Для коммерческого использования нужно письменное согласие правообладателя (лицензия MediaCrawler).

У Spider_XHS и xiaohongshu-cli на GitHub лицензия не указана. GitHub поясняет, что без лицензии все права остаются за автором. Больше ни у кого нет разрешения использовать, изменять или распространять код (документация GitHub о лицензиях). Компании, которая встроит такой код в продукт или включит его в решение для клиента, будет сложно согласовать это со своими юристами.

API для парсинга Xiaohongshu с оплатой за каждый вызов: что мы протестировали

Третий вариант — API данных с оплатой за каждый запрос. Вы отправляете HTTP-запрос, провайдер возвращает страницу структурированных данных, и вы платите за каждый запрос. 4 ноября 2026 года с 00:14 до 00:20 по сингапурскому времени мы выполнили реальные вызовы API через EveryInfra. Мы сделали девять платных вызовов API для шести действий Xiaohongshu. Ещё для трёх запросов мы намеренно вызвали ошибки. При выполнении ещё четырёх запросов был превышен лимит запросов (429), но после повторной отправки они выполнились успешно.

Сначала мы ознакомились с бесплатным каталогом, чтобы проверить параметры и цены (каталог, просмотрен в 00:13 по сингапурскому времени). Для Xiaohongshu доступно 17 действий. Шестнадцать из них стоят $0,005556 за вызов API, а один рейтинговый список для маркетинга с участием блогеров — $0,016. Поиск, посты пользователя и поиск товаров возвращают по 20 записей на страницу, комментарии — 15, а ответы — 10. Токен пагинации действует 24 часа.

Девять вызовов API обошлись в общей сложности в $0,061115, что соответствует 11 единицам тарификации: пакетный запрос для 3 постов учитывается как 3 единицы.

Мы делим сумму списания на число полученных записей, а не на указанный в каталоге размер страницы. Поэтому вызовы API, вернувшие 19 записей, в пересчёте на запись стоят чуть дороже. Наибольшая разница возникает при получении деталей поста. Такой вызов API стоит те же $0,005556, что и поиск, но поиск возвращает 20 постов, а вызов для получения деталей — 1. В пересчёте на запись получение деталей обходится в 20 раз дороже. Для массового анализа используйте поля, которые уже приходят в результатах поиска (заголовок, фрагмент текста, лайки, сохранения, число комментариев, дату и автора), а действие для получения деталей вызывайте только тогда, когда нужны дополнительные данные.

Читателям за пределами Китая стоит подробнее рассмотреть тест с английским запросом. Мы искали «Singapore food» без дополнительных фильтров. Поиск вернул 19 постов, но английские слова содержались только в 4 заголовках. Остальные были на китайском, то есть платформа сопоставляет английский запрос с китайским контентом на ту же тему. Только 3 из 19 постов были опубликованы менее 30 дней назад, а медианный возраст поста составил 242 дня.

Так происходит потому, что по умолчанию результаты сортируются по релевантности, а не теряющие актуальности руководства занимают высокие позиции. Пост с наибольшим числом комментариев (412) оказался опубликованной в сентябре 2025 года жалобой на слишком дорогой обед. У поста о дешёвом дуриане, опубликованного в январе 2026 года, было 80 комментариев. Чтобы увидеть публикации по теме за текущую неделю, задайте параметру sort значение newest или добавьте date_range. Без них вы будете читать в основном старые руководства.

Эти две ключевые фразы дают совершенно разные результаты. В обоих случаях использовалась сортировка по умолчанию:

Тест выявил ещё четыре детали. Во-первых, пагинация действительно продвигается вперёд: на странице 2 не было ни одного поста со страницы 1. Из 40 постов 21 был опубликован менее 30 дней назад, 12 — менее 7 дней назад, а самому старому был 231 день. Во-вторых, вызов API для получения деталей заново считывает актуальные данные поста. В результатах поиска у поста был 231 комментарий, а в ответе с деталями двумя секундами позже — 232. Ответ с деталями также содержит регион по IP, 8 тематических тегов и список из 10 изображений.

В-третьих, для ответов нужен отдельный вызов API. Для 15 комментариев верхнего уровня на странице 1 было заявлено 53 ответа, но непосредственно в данных каждого комментария содержался только 1 ответ. Чтобы получить полные ветки, вызывайте xiaohongshu/sub_comments. В-четвёртых, comments_batch тарифицируется за каждый пост. Три поста стоят трижды по $0,005556, поэтому цена за комментарий такая же, как при отдельных вызовах API. Пакетный вызов сокращает число запросов и снижает нагрузку на лимит запросов, но не экономит деньги.

Как подключиться: curl, поля ответа и MCP

Проще всего подключиться одним POST-запросом. Ниже — поиск по английскому запросу из таблицы. Храните API-ключ в переменной окружения, а не в коде:

curl -s 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":"Singapore food","sort":"newest","date_range":"last_7_days"}}'
# Next page: copy next_page_token into params.page_token. For slow jobs add "mode":"async" and poll the job_id.

Поля ответа соответствуют списку response_fields в каталоге. В таблице — группы, которые мы использовали, и что мы увидели в тесте:

Для ИИ-клиентов EveryInfra работает как удалённый MCP-сервер. MCP (Model Context Protocol) — открытый протокол, который позволяет ИИ-клиенту вызывать внешние инструменты (спецификация). Названия всех инструментов начинаются с everyinfra_. Добавьте этот блок в клиент, и можно начинать:

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}" }
    }
  }
}

Дальше можно просить обычными словами: «Найди в Xiaohongshu посты о сингапурской уличной еде за последние 7 дней. Оставь те, у которых больше 20 комментариев, и получи по одной странице комментариев для каждого. Перечисли блюда, на которые жалуются». Страницы действий и песочница находятся в разделах API данных Xiaohongshu и поиск. Проверки настройки MCP описаны в разделе настройка удалённого MCP, а инструменты Xiaohongshu перечислены на странице Xiaohongshu MCP.

Сбои, пустые результаты и лимиты запросов: за что не берут деньги

Главное опасение при оплате за вызов API — заплатить, ничего не получив. Мы намеренно вызвали ошибки в трёх запросах: один вернул пустой результат, второй содержал неверный параметр, а третий был отправлен без API-ключа. При выполнении ещё четырёх запросов был превышен лимит запросов (429). Ни за один из семи запросов деньги не списали:

Получение пустого результата заняло 29 секунд. В ответе указано: count — 0, reason — empty_result_refunded; деньги не списаны. Ошибка 422 перечисляет допустимые значения, что помогает модели ИИ, вызывающей API.

Модель читает did_you_mean и сама исправляет запрос.

Лимит запросов действует на уровне аккаунта и является общим для всех его API-ключей, поэтому дополнительные ключи его не увеличивают. Лимит аккаунта зависит от общей суммы пополнений баланса (Тарифы).

Четыре ответа 429 не входили в план. У нашего тестового ключа было собственное ограничение в 10 вызовов в минуту. С 00:14:59 до 00:15:48 мы сами отправили только 4 вызова, значит, тем же ключом одновременно пользовались другие тесты.

Каждый ответ 429 содержал «Nothing was charged» и retry_after от 5 до 17 секунд. Мы повторили эти четыре запроса через 77–147 секунд, и все четыре прошли по обычной цене $0,005556. В задаче, запускаемой по расписанию, дождитесь окончания интервала retry_after, сделайте повторную попытку и закладывайте в длительность каждого запуска время ожидания в очереди. Полный метод сверки списаний и возвратов средств описан в разделе сверка возвратов за сбои.

Стоимость API Xiaohongshu: в 10 раз выше, чем у TikTok, поэтому планируйте расходы отдельно

Скажем прямо: в нашем собственном каталоге Xiaohongshu — самая дорогая социальная платформа. Мы взяли медианную цену всех доступных действий на каждой платформе. У Xiaohongshu это $0,005556 за вызов.

У TikTok, YouTube, Instagram, Bilibili и Reddit — $0,000556, ровно в десять раз меньше. У Douyin, Kuaishou, Weibo, Zhihu и X — $0,000806, то есть Xiaohongshu дороже в 6,9 раза. У Taobao и JD — $0,001389, то есть Xiaohongshu дороже в 4 раза. Немного дороже только Amazon с медианой $0,006875.

Каталожная цена Xiaohongshu в 4–10 раз выше, чем у других платформ. Актуальные цифры есть на странице тарифов. В пересчёте на бюджет $10 в месяц хватит примерно на 1 800 вызовов Xiaohongshu по $0.005556 и примерно на 18 000 вызовов по медианной цене TikTok $0.000556.

Для вас это означает, что при том же бюджете запросов к Xiaohongshu будет примерно в десять раз меньше, чем к TikTok. Если один проект охватывает обе платформы, не закладывайте для них одинаковую цену за вызов. На странице API данных TikTok указана цена для этого API. А ещё это означает, что следующий раздел о том, как сократить число вызовов, здесь важнее, чем для других платформ.

Как сократить число вызовов: пять привычек и один ежемесячный счёт

Первое: начинайте со списков, а детали запрашивайте потом. Поиск и посты пользователя возвращают по 20 записей на страницу с заголовком, фрагментом, лайками, сохранениями, числом комментариев, датой и ссылкой. Для большинства задач сортировки и фильтрации больше ничего не нужно.

Вызывайте xiaohongshu/note, только когда нужны регион по IP, теги тем или полный текст. Каждая запись с подробными данными стоит в 20 раз дороже записи в списке. Второе: проверяйте число комментариев, прежде чем выгружать комментарии. В нашей выборке из 40 постов медианное число комментариев было 14, и только у 18 постов их было 20 и больше.

Запрос комментариев к посту, у которого 0 комментариев, вернёт пустой результат. Это бесплатно, но всё равно занимает один слот лимита запросов. Третье: используйте фильтры по времени вместо полной повторной выгрузки. Ежедневная задача может задавать sort со значением newest и date_range со значением last_24_hours или last_7_days и обрабатывать только новые посты.

Четвёртое: раскрывайте ветки ответов только при необходимости. sub_comment_count уже показывает, сколько ответов у каждого комментария, так что раскрывайте только ветки с большим числом ответов. Пятое: запускайте задачу не чаще, чем нужно бизнесу. Многим отчётам по конкурентам вполне хватает раза в неделю.

В таблице использована каталожная цена — $0,005556. Доля постов с 20 и более комментариями — 18 из 40 — взята из нашей выборки. Это оценка, а не счёт.

С вашими ключевыми словами доля будет другой. Стоимость того же мониторинга падает с $70,01 до $4,44 в месяц, то есть в 15,8 раза. Экономия достигается за счёт меньшего числа вызовов, а не более низкой цены за единицу. Здесь помогает оплата за каждый вызов: каждый вызов виден, поэтому можно заранее посчитать, сколько сэкономит каждое сокращение.

Подробнее о второй привычке на примере тех же 40 постов о солнцезащитных средствах из нашего поиска. Всего у них было 1 177 комментариев. У одиннадцати постов было 0 комментариев, у 18 — 20 и более, а у самого обсуждаемого — 231. В таблице используются каталожная цена $0.005556 за страницу и 15 комментариев на странице:

Последняя строка: $0.444 за 1 000 комментариев. Это больше, чем $0.370 для первой страницы, потому что последняя страница поста часто заполнена не полностью.

Поэтому сначала решите, действительно ли вам нужны все комментарии. Для разметки мнений часто хватает 15 комментариев верхнего уровня к каждому посту. Загружайте все страницы, только если вам нужна доля по всем комментариям, например доля комментариев, где упоминается бренд. Так же можно оценить и отдельный пост. Для поста, у которого при вызове данных поста было 232 комментария, потребуется 16 страниц, то есть $0,0889.

С ответами всё так же. У 15 комментариев верхнего уровня на одной странице было указано 53 ответа, и каждый комментарий уже содержал 1 ответ. Чтобы открыть все остальные ответы через xiaohongshu/sub_comments по 10 записей на страницу, нужно 14 вызовов, или $0,0778. Если открыть только 4 комментария с 5 и более ответами, хватит 4 вызовов, или $0,0222. Это дешевле более чем на 70%, а самые активные ветки при этом остаются.

И наконец, учитывайте время. Наш тестовый ключ допускает 10 вызовов в минуту. С такой скоростью ежедневному плану с комментариями ко всем постам нужно 420 вызовов в день, то есть 42 минуты в очереди. Еженедельному плану с комментариями только к активным постам нужно 200 вызовов за запуск, то есть 20 минут. Лимиты аккаунта зависят от общей суммы пополнений баланса, поэтому сверьтесь со страницей «Тарифы». При любом лимите меньшее число вызовов означает и меньше времени в очереди, и меньше ошибок из-за превышения лимита запросов.

Как сравнивать цены сторонних сервисов: одна формула и шесть вопросов

Многие сторонние сервисы берут оплату за каждый запрос, но указывают цены по-разному: одни за вызов, другие за запись, третьи за кредит. Некоторые добавляют ежемесячную плату или плату за подключение. Чтобы сравнить их, используйте одну формулу: цена за 1 000 записей = цена запроса ÷ число записей, фактически возвращённых за запрос × 1 000.

Условный пример: сервис берёт $0.01 за вызов и возвращает 10 записей, то есть 1 000 записей стоят $1.00. При тех же $0.01 и 20 записях выходит $0.50. Поэтому «цена за вызов» сама по себе мало что говорит. Уточните, сколько записей возвращает каждая страница, а лучше сделайте один вызов и посчитайте сами. По этой формуле наш поиск по Xiaohongshu стоит $0.278 за 1 000 постов, а комментарии — $0.370 за 1 000.

Вторую, третью и четвёртую строки таблицы чаще всего пропускают. Из-за редких ключевых слов и ИИ-клиентов, которые иногда передают неверный параметр, стоимость неудачных запросов становится частью ежемесячного счёта. В нашем тесте все семь запросов, не вернувших данных (три запланированные ошибки и четыре превышения лимита запросов), стоили $0. Задайте эти вопросы, затем сами сделайте один вызов и посчитайте записи. Цены и правила указаны на странице «Тарифы».

Основы комплаенса: законы, правила платформы и практики для тех, кто работает с данными

Это не юридическая консультация. Мы перечисляем основные положения закона и правил платформы. По своему сценарию использования проконсультируйтесь с юристом. К данным Xiaohongshu напрямую относятся три нормы китайского права.

Статья 27 Закона КНР о защите персональной информации касается общедоступной персональной информации. Она допускает обработку «в разумных пределах», если человек сам сделал данные общедоступными или если они уже правомерно опубликованы. Это правило не действует, если человек явно возражает. Если обработка существенно затрагивает человека, необходимо его согласие (Закон о защите персональной информации).

Статья 18 Положения об управлении безопасностью сетевых данных касается автоматизированных инструментов для доступа к сетевым данным и их сбора. Пользователь такого инструмента обязан оценить его влияние на сетевой сервис. Инструмент не должен проникать в чужие сети или нарушать нормальную работу сервиса (текст положения). Положение действует с 1 января 2025 года (Министерство юстиции КНР).

Закон о противодействии недобросовестной конкуренции в редакции 2025 года дополнен пунктом 3 статьи 13. Согласно ему, компания не вправе путём обмана или принуждения получать или использовать данные, которыми правомерно владеет другая компания. Для этого также нельзя обходить или взламывать технические средства защиты. Новая редакция закона вступила в силу 15 октября 2025 года (Закон о противодействии недобросовестной конкуренции, 2025).

Действуют и два набора правил платформы. Пользовательское соглашение Xiaohongshu обновлено 23 марта 2026 года. Разделы 3.4 и 4.1 ограничивают чтение, подсчёт и коммерческое использование контента платформы без письменного разрешения. Они также ограничивают парсинг и имитацию скачивания.

Раздел 2.3 также ограничивает передачу аккаунта другим лицам (пользовательское соглашение). Для пользователей за пределами материкового Китая с 9 июня 2026 года действуют условия RedNote. Они тоже ограничивают автоматизированное извлечение данных (Условия использования RedNote). Уточните у юриста, попадает ли ваш сценарий под эти ограничения.

Суды в Китае присуждали возмещение ущерба по делам о масштабном сборе и перепродаже данных платформ без разрешения. Как правило, суды задают четыре вопроса. Обходил ли сборщик технические средства защиты или взламывал их? Превратились ли разрозненные записи в крупный массив данных для перепродажи? Затрагивались ли персональные данные или закрытые функции? Пострадала ли нормальная работа платформы?

Какой бы путь вы ни выбрали, тому, кто работает с данными, стоит как минимум придерживаться следующих правил:

• Используйте данные только для законной и чётко определённой цели, например для мониторинга упоминаний бренда или исследования продуктов. Зафиксируйте цель письменно и ещё раз проверьте её, прежде чем менять.
• Соблюдайте правила платформы и законы страны, в которой работаете. Консультируйтесь с юристом перед любым использованием, которое ограничено правилами, например перед коммерческой перепродажей или массовым скачиванием контента.
• Сводите персональные данные к минимуму. Считайте ники, аватары и IP-регионы в комментариях персональными данными. Не храните поля, которые не используются в анализе. По возможности храните итоговые значения, а не отдельные записи. Зафиксируйте, как долго и зачем вы храните данные.
• Не перепродавайте сырые данные. Передавайте клиентам выводы и сводные таблицы, а не наборы сырых записей, и не публикуйте сырые записи.
• Собирайте только те данные, которые нужны для анализа, и удаляйте старые сырые данные по расписанию.
• Не трогайте личные сообщения, закрытые аккаунты и другой непубличный контент. Не используйте данные для массовой рассылки сообщений пользователям.

Эти рекомендации согласуются с приёмами из раздела «Как делать меньше вызовов». Если собирать только те данные, которые используются в анализе, вы платите меньше, а хранить и защищать данных тоже приходится меньше.

Какой путь выбрать в зависимости от задачи

Если вы создаёте собственное приложение и вам нужен вход через Xiaohongshu, используйте платформу аккаунтов и запросите basic_info. Создайте приложение, укажите адрес обратного вызова и дождитесь проверки: она занимает от 1 до 3 рабочих дней. Если вы продаёте на Xiaohongshu и хотите видеть заказы и послепродажное обслуживание в своей ERP, используйте открытую платформу электронной коммерции. Выберите роль собственной разработки, если у вас есть разработчики, или найдите подрядчика на маркетплейсе сервисов. Если вы покупаете рекламу и хотите выгружать отчёты массово, попросите менеджера по продажам платформы открыть Marketing API. Ни для одной из этих трёх задач сторонний сервис не нужен, и использовать его для них не стоит.

Если ваша задача в том, чтобы следить за другими, официальные пути сейчас не помогут. К таким задачам относятся число публикаций и вовлечённость конкурентов, мнения пользователей по теме, рекомендации товаров и образ бренда на платформе. Можно выбрать скрипт или сторонний API. Для небольших, разовых или учебных задач хватит скрипта с открытым исходным кодом. Используйте аккаунт, который не жалко потерять, и прочитайте лицензию. Для ежедневной задачи, работы для клиента или ИИ-клиента, который сам запрашивает данные, удобнее API с оплатой за каждый вызов.

Сокращайте объём с помощью приёмов из раздела «Как делать меньше вызовов» и соблюдайте практики из раздела о комплаенсе. Это важно и для иностранных брендов. В материале Inside Retail Asia от 12 октября 2026 года говорится, что люди пользуются приложением как поисковой системой (Inside Retail Asia).

Поэтому исследование ключевых слов обычно говорит бренду больше, чем число подписчиков. Подробнее об этом в двух связанных статьях. В статье Экспорт данных Xiaohongshu и анализ снимков показано, как сохранять данные поиска и комментариев в виде снимков. В статье Пакетная загрузка комментариев Xiaohongshu приведены все шаги для пакетной загрузки комментариев.

Новости отрасли: октябрь и ноябрь 2026 года

• 3 ноября 2026 года: за день до нашей выборки в MediaCrawler, xiaohongshu-mcp и XiaohongshuSkills появились новые коммиты. За последние 30 дней у них было 11, 35 и 32 коммита соответственно. ReaJason/xhs по-прежнему не обновлялся с 1 июля 2025 года (GitHub API, данные на 00:19:50 по сингапурскому времени 4 ноября 2026 года). Что это значит: активно развиваемые инструменты постоянно меняются, и вам придётся обновляться вместе с ними. Инструменты, которые перестали обновляться, не подходят для задачи по расписанию.
• 21–23 октября 2026 года: за одну неделю в репозитории xiaohongshu-mcp открыли задачи «не удаётся войти» и «поиск ограничен». 1 ноября мейнтейнер объединил исправления, связанные с ожиданием результатов поиска и процессом публикации. 3 ноября последовало исправление очистки браузера после неудачного входа (история коммитов). Что это значит: инструменты, которые зависят от входа в аккаунт, приходится дорабатывать каждые несколько недель, поэтому для задачи по расписанию нужно оповещение о сбоях.
• 17 октября 2026 года: веб-страницы сайта изменили формат серверных данных. XHS-Downloader, загрузчик с более чем 13 000 звёзд, перестал разбирать посты до выхода исправления (issue 497). Что это значит: изменение страницы в обычный будний день может остановить все скрипты, которые её читают, поэтому закладывайте время на исправление.
• 19 августа 2026 года: справочник API платформы аккаунтов обновился, но открыт по-прежнему только basic_info (справочник API). Что это значит: в ближайшее время не рассчитывайте на официальный API для чтения постов.

С чего начать: от одного тестового вызова до еженедельной задачи

Шаг первый: зарегистрируйтесь в EveryInfra и создайте API-ключ. Ежемесячной платы нет, а пополненный баланс не сгорает. Порядок действий описан в разделе Быстрый старт. Шаг второй: изучите бесплатный каталог. Затем попробуйте сделать один вызов на странице действия. Страницы для постов: поиск, детали поста и посты пользователя.

Страницы для комментариев: комментарии, пакетные комментарии и ответы. Для магазинов используйте поиск товаров. Шаг третий: посмотрите charged_usd и число записей в ответе и рассчитайте свою цену за 1 000 записей по формуле «списание ÷ записи × 1,000». Затем оцените месячные расходы по таблице из раздела «Как делать меньше вызовов». Шаг четвёртый: добавьте блок MCP в свой ИИ-клиент и попросите его раз в неделю прогонять ваши ключевые слова. Другие платформы есть на рынке данных, а состояние сервисов — на странице Статус сервисов.

FAQ

Есть ли у Xiaohongshu официальный API?

Этот вопрос взят из поисковых подсказок вроде «xiaohongshu api documentation» и «rednote api documentation». Да, но только для ваших собственных данных. Платформа аккаунтов открывает только basic_info (ник, аватар, пол и регион). Платформа электронной коммерции позволяет компаниям и подрядчикам читать заказы и товары магазинов, которые их авторизовали. Рекламный API выдаёт рекламодателям их собственные отчёты (список scope, авторизация магазина). Официального API для чтения чужих публичных постов или комментариев нет, а read_notes по-прежнему в статусе «запланировано».

Как получить API-ключ Xiaohongshu?

Этот вопрос взят из подсказок «xiaohongshu api key» и «rednote api key». Единого официального «API-ключа» нет. На платформе аккаунтов вы создаёте приложение и получаете app id и app secret. Проверка занимает примерно от 1 до 3 рабочих дней (Быстрый старт).

На платформе электронной коммерции верифицированная компания получает appId и appSecret, после чего основной аккаунт магазина должен её авторизовать. Регистрацию в рекламном API запускает менеджер по продажам. Если вам нужен ключ для чтения публичных постов, это будет ключ стороннего сервиса. В EveryInfra его можно создать в консоли после регистрации.

Можно ли использовать парсеры Xiaohongshu с GitHub в коммерческом продукте?

Этот вопрос взят из подсказки «xiaohongshu api github». Проверьте лицензию. Среди девяти проектов нашей выборки лицензия MediaCrawler разрешает только некоммерческое использование в учебных целях и запрещает масштабный краулинг (лицензия).

У Spider_XHS и xiaohongshu-cli лицензия не указана, поэтому все права остаются за авторами. xiaohongshu-mcp распространяется под Apache-2.0, а XHS-Downloader — под GPL-3.0. Лицензия распространяется только на код. На данные, собранные с его помощью, она не распространяется. К этим данным по-прежнему применяются правила платформы и закон.

Работает ли аккаунт RedNote со скриптами для Xiaohongshu?

Этот вопрос взят из подсказок «rednote xiaohongshu api» и «rednote api github». Часто не работает. Причина изменения объясняется в issue #579 репозитория xiaohongshu-mcp.

Аккаунты, зарегистрированные на некитайский номер телефона после 8 декабря 2025 года, являются аккаунтами RedNote. Их веб-сессия переходит на rednote.com, и меняется домен cookie. Скрипты, которые читают только cookie xiaohongshu.com, после этого сообщают «вход не выполнен». Для пользователей RedNote также действуют отдельные условия: они вступили в силу 9 июня 2026 года и запрещают автоматизированное извлечение данных (условия RedNote).

Как обычно устроены цены на API Xiaohongshu?

Этот вопрос взят из подсказок «xiaohongshu api pricing» и «xiaohongshu api pricing reddit». Официальные каналы не указывают платы за сам API. Сторонние сервисы обычно берут оплату за запрос, за запись или за кредит, а некоторые добавляют ежемесячную плату. Прежде чем сравнивать, переведите каждую цену в цену за 1 000 записей по формуле из раздела о сравнении цен. В EveryInfra 16 из 17 действий для Xiaohongshu стоят $0.005556 за вызов. В нашем тесте это дало $0.278 за 1 000 постов из поиска и $0.370 за 1 000 комментариев (каталог).

Источники

1. «Developer portal home», открытая платформа Xiaohongshu, дата обращения: 2026-11-04. https://openaccount.xiaohongshu.com/
2. «Scope list», открытая платформа Xiaohongshu, обновлено 2026-03-29, скриншот от 2026-11-04. https://openaccount.xiaohongshu.com/docs/scope
3. «API reference», открытая платформа Xiaohongshu, обновлено 2026-08-19. https://openaccount.xiaohongshu.com/docs/api-reference
4. «Quick start», открытая платформа Xiaohongshu, обновлено 2026-03-29. https://openaccount.xiaohongshu.com/docs/quick-start
5. «Authorization flow for software vendors», открытая платформа электронной коммерции Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/38
6. «Signature method», открытая платформа электронной коммерции Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/39
7. «Developer document index», открытая платформа электронной коммерции Xiaohongshu. https://open.xiaohongshu.com/document/developer/file/4
8. «Developer role guide», сторонняя копия документации платформы электронной коммерции. https://xiaohongshu.apifox.cn/doc-2811119
9. «Marketing API getting started guide», рекламная платформа Xiaohongshu, обновлено 2024-01-03. https://ad.xiaohongshu.com/openApiDoc?categoryId=761&articleId=3047
10. «Share open platform home», Xiaohongshu. https://agora.xiaohongshu.com/index
11. Пост на форуме о приостановке открытой платформы Share, V2EX, 2025-11-06. https://global.v2ex.co/t/1170874
12. «Mini program open platform», Xiaohongshu. https://miniapp.xiaohongshu.com/
13. «Xiaohongshu user agreement», обновлено 2026-03-23. https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1
14. «RedNote Terms of Service», действует с 2026-06-09. https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1
15. NanmiCoder/MediaCrawler, GitHub, дата обращения: 2026-11-04. https://github.com/NanmiCoder/MediaCrawler
16. «MediaCrawler NON-COMMERCIAL LEARNING LICENSE 1.1», GitHub. https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
17. xpzouying/xiaohongshu-mcp, GitHub. https://github.com/xpzouying/xiaohongshu-mcp
18. История коммитов xiaohongshu-mcp, GitHub. https://github.com/xpzouying/xiaohongshu-mcp/commits/main
19. xiaohongshu-mcp, issue 880 «cannot log in», 2026-10-23. https://github.com/xpzouying/xiaohongshu-mcp/issues/880
20. xiaohongshu-mcp, issue 877 «search is limited», 2026-10-21. https://github.com/xpzouying/xiaohongshu-mcp/issues/877
21. xiaohongshu-mcp, issue 878 «does the platform allow this tool», 2026-10-22. https://github.com/xpzouying/xiaohongshu-mcp/issues/878
22. xiaohongshu-mcp, issue 579 «support for rednote.com users», 2026-03-13. https://github.com/xpzouying/xiaohongshu-mcp/issues/579
23. JoeanAmier/XHS-Downloader, GitHub. https://github.com/JoeanAmier/XHS-Downloader
24. XHS-Downloader, issue 497 «server-side data parse failure», 2026-10-17. https://github.com/JoeanAmier/XHS-Downloader/issues/497
25. XHS-Downloader, issue 479 «slower crawl setting», 2026-09-15. https://github.com/JoeanAmier/XHS-Downloader/issues/479
26. cv-cat/Spider_XHS, GitHub. https://github.com/cv-cat/Spider_XHS
27. Spider_XHS, issue 191 «Cookie is invalid or expired», 2026-10-10. https://github.com/cv-cat/Spider_XHS/issues/191
28. jackwener/xiaohongshu-cli, GitHub. https://github.com/jackwener/xiaohongshu-cli
29. xiaohongshu-cli, issue 82 «forced login every 7 days», 2026-08-17. https://github.com/jackwener/xiaohongshu-cli/issues/82
30. ReaJason/xhs, GitHub. https://github.com/ReaJason/xhs
31. white0dew/XiaohongshuSkills, GitHub. https://github.com/white0dew/XiaohongshuSkills
32. autoclaw-cc/xiaohongshu-skills, GitHub. https://github.com/autoclaw-cc/xiaohongshu-skills
33. Jamailar/Beav, GitHub. https://github.com/Jamailar/Beav
34. Cloxl/xhshow, библиотека подписи запросов, GitHub. https://github.com/Cloxl/xhshow
35. «List repository issues», документация GitHub REST API. https://docs.github.com/en/rest/issues/issues#list-repository-issues
36. «Licensing a repository», документация GitHub. https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
37. «Personal Information Protection Law of the PRC», Администрация киберпространства Китая. https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
38. «Network Data Security Management Regulations (State Council Order 790)», копия на сайте Министерства экологии и окружающей среды КНР. https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
39. «Release of the Network Data Security Management Regulations», Министерство юстиции КНР, 2024-09-30. https://www.moj.gov.cn/pub/sfbgw/gwxw/xwyw/202409/t20240930_507076.html
40. «Anti-Unfair Competition Law of the PRC, 2025 revision», Государственное управление интеллектуальной собственности КНР. https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
41. «Less shouting, more answering: How brands win on XHS», Inside Retail Asia, 2026-10-12. https://insideretail.asia/2026/10/12/less-shouting-more-answering-how-brands-win-on-xhs/
42. Ветка форума V2EX t/1170609 (мы цитируем ответы в ней об эндпоинтах страниц маркетплейса блогеров), V2EX. https://www.v2ex.com/t/1170609
43. Каталог социальных данных EveryInfra (доступен бесплатно), дата обращения: 2026-11-04, 00:13 по сингапурскому времени. https://api.everyinfra.com/api/v1/social/catalog
44. «Model Context Protocol specification 2025-06-18». https://modelcontextprotocol.io/specification/2025-06-18