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

rednote/comment-replies
Комментарии1 кредит за запрос

rednote/home-recommendations
Публикации1 кредит за запрос

rednote/note-comments
Комментарии1 кредит за запрос

rednote/note-detail
Публикации1 кредит за запрос

rednote/search-notes
Поиск1 кредит за запрос

rednote/search-users
Поиск1 кредит за запрос

rednote/user-notes
Публикации1 кредит за запрос

rednote/user-profile
Профили1 кредит за запрос
Какие данные 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. Выберите эндпоинт
Выберите эндпоинт профиля, заметки, поиска, комментариев, ответов или рекомендаций для своей задачи по сбору публичных данных.
2. Отправьте корректные входные данные
Отправляйте методом POST только объявленные поля и сохраните возвращенный task_id.
3. Читайте нормализованные результаты
Опрашивайте задачу до конечного статуса, затем читайте data.results.items и используйте next_cursor только для пагинации сохраненных результатов.
Пройдите аутентификацию с 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 магазина в виде нормализованных записей приложений и отзывов.