Ко всем API
Публичные данные Rednote

Rednote Public Data APIs

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

Доступные API Rednote

Выбирайте из восьми API для работы с профилями, заметками, комментариями, ответами, поиском и рекомендациями.

Какие данные Rednote можно получить?

Каталог Rednote возвращает нормализованные записи аккаунтов, публикаций и комментариев из публичных исходных данных.

Профили и заметки пользователя

Получайте один публичный профиль или собирайте одну исходную страницу заметок по поддерживаемому URL аккаунта или user_id.

Детали заметок и поиск

Получайте одну заметку по URL с токеном, ищите заметки с поддерживаемыми фильтрами или собирайте страницу рекомендаций главной ленты.

Поиск пользователей

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

Комментарии и ответы

Собирайте одну страницу публичных комментариев к заметке или одну страницу ответов для известного ID комментария.

Спецификации API Rednote вкратце

Каждый эндпоинт делает ограниченный запрос к источнику и отклоняет необъявленные параметры.

Группа APIВходные данныеОграничение источника
Профиль и заметки пользователяurl или user_idОдин профиль или одна исходная страница; без results_limit
Детали заметкиПоддерживаемый URL с путем заметки и xsec_tokenНе более одной записи заметки
ПоискНепустой query и поддерживаемые необязательные enum-значенияФиксированная первая исходная страница; без results_limit
Комментарии и ответыПоддерживаемый URL заметки; для ответов нужен также comment_idОдна страница ответа источника
Рекомендации главной лентыВсе поля необязательныОдна страница с results_limit 1–40, по умолчанию 20

Как работают API Rednote

Все восемь эндпоинтов используют один и тот же асинхронный процесс: отправка, опрос и сохраненные результаты.

  1. 1. Выберите эндпоинт

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

  2. 2. Отправьте корректные входные данные

    Отправляйте методом POST только объявленные поля и сохраните возвращенный task_id.

  3. 3. Читайте нормализованные результаты

    Опрашивайте задачу до конечного статуса, затем читайте data.results.items и используйте next_cursor только для пагинации сохраненных результатов.

Поиск публичных заметок Rednote

Пройдите аутентификацию с API-ключом SocQ и отправьте запрос с поддерживаемыми необязательными фильтрами. Каждая успешная задача Rednote стоит фиксированно 1 кредит.

curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"travel guide","sort_by":"general","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Типичные сценарии использования API Rednote

Исследование авторов и контента

Объединяйте публичные данные аккаунта с ограниченной страницей заметок этого автора.

Поиск тем

Сравнивайте снимки поиска заметок, поиска пользователей и рекомендаций главной ленты с метками времени сбора.

Анализ обсуждений

Изучайте комментарии к публичной заметке и вложенные ответы на выбранный комментарий в виде нормализованных записей.

Ограничения и политика публичных данных

Эти эндпоинты читают публичные данные через ограниченные запросы к источнику и не выполняют действий от имени аккаунта и не дают приватного доступа.

  • Поддерживаются хосты xiaohongshu.com, xhslink.com и их поддомены; Note Detail дополнительно требует путь /explore/{id} или /discovery/item/{id} и непустой xsec_token.
  • user_id и comment_id принимают 1–256 символов: латинские буквы и цифры ASCII, двоеточия, подчеркивания или дефисы.
  • Search Notes принимает sort_by, media_type и published_within только из перечисленных enum-значений; Search Users принимает только query.
  • results_limit принимает только Home Recommendations: диапазон 1–40, по умолчанию 20.
  • Каждая успешная задача Rednote стоит фиксированно 1 кредит.

Частые вопросы об API Rednote

Что такое API Rednote?

API Rednote возвращают публичные профили, заметки, комментарии, вложенные ответы, результаты поиска и рекомендации главной ленты в виде нормализованных записей.

Какой эндпоинт принимает results_limit?

results_limit принимает только Home Recommendations — целое число от 1 до 40. Остальные эндпоинты Rednote его отклоняют.

Принимает ли Note Detail любой URL Rednote?

Нет. Нужен допустимый хост, путь /explore/{id} или /discovery/item/{id} и непустое значение xsec_token в строке запроса.

Сколько стоят запросы к Rednote?

Каждая успешная задача стоит фиксированно 1 кредит SocQ.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

Kwai API

Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.

Truth Social API

Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.

Google Ad Library API

Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.

Google Maps API

Находите публичные места, получайте нормализованные данные по известным URL Maps и собирайте публичные отзывы с привязанным к источнику контекстом места и автора.

Amazon API

Ищите публичные товары Amazon и собирайте нормализованные записи карточек товаров, бестселлеров, отзывов, профилей продавцов и витрин авторов с поддерживаемых маркетплейсов.

Apple App Store API

Собирайте публичные данные о приложениях Apple App Store, рейтинги категорий и отзывы по известным URL магазина в виде нормализованных записей приложений и отзывов.