rednote/
user-notes

Собирайте одну страницу публичных заметок Rednote по поддерживаемому URL пользователя или ID пользователя и получайте нормализованный текст, авторов, медиа, метки времени и видимую вовлеченность.

Rednote User Notes API

URL или ID пользователя
Одна страница источника
Нормализованные публичные заметки
1 кредит за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Rednote User Notes

Заметки пользователей Rednote — это публичные публикации аккаунта с текстом, указанием автора, медиа, временем публикации и видимым числом взаимодействий. Эти поля контента и контекста помогают изучать аккаунты, анализировать закономерности публикаций, сравнивать форматы и оценивать результативность на определенный момент времени.

Возможности Rednote User Notes API

  • Два способа указать аккаунт с понятным приоритетомПринимает поддерживаемую ссылку на пользователя Rednote или user_id; если переданы оба поля, используется явно указанный user_id.
  • Сбор заметок аккаунта с одной страницыПолучает публичные заметки, возвращенные одним запросом к источнику для выбранного аккаунта, без курсора источника и без лимита результатов, задаваемого вызывающей стороной.
  • Нормализованный контекст заметки и автораВозвращает ID заметок, публичные URL, текст, данные об авторе, ссылки на медиа, время публикации и время сбора в единой структуре PostItem.
  • Снимки видимой вовлеченностиСохраняет доступное число лайков, комментариев, репостов и просмотров вместе с collected_at для сравнения в заданных временных рамках.

Параметры Rednote User Notes API

ПараметрыОбязательныйОписание
urlОбязательный (хотя бы один)Непустая ссылка на пользователя Rednote, имя хоста которой после разбора — xiaohongshu.com, xhslink.com или поддомен одного из них. Определенный шаблон пути не требуется; если URL содержит /user/<identifier>, а user_id пуст, используется этот идентификатор, иначе принятый URL остается ссылкой на аккаунт.
user_idОбязательный (хотя бы один)Идентификатор пользователя Rednote длиной от 1 до 256 символов: латинские буквы ASCII, цифры, двоеточия, подчеркивания или дефисы. Укажите url или user_id; если переданы оба, приоритет у явно указанного user_id.

Как использовать Rednote User Notes API

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

  1. Подготовьте непустой URL пользователя Rednote на допустимом хосте или корректный user_id; оставьте второе поле пустым, если оно не нужно.
  2. Отправьте url или user_id методом POST на /v1/rednote/user-notes и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items и следуйте next_cursor, пока has_more равно true; этот курсор листает сохраненные записи, а не дополнительные страницы источника Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_USER_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Rednote User Notes API

  • Опись публикаций публичного аккаунта: Используйте ID заметок, публичные URL, текст, указание автора и время публикации, чтобы каталогизировать возвращенный снимок аккаунта.
  • Анализ форматов контента: Сравнивайте доступные ссылки на изображения и видео, размеры, миниатюры и текст среди возвращенных заметок аккаунта.
  • Анализ закономерностей публикаций: Упорядочивайте заметки по published_at и рассматривайте текст вместе с медиа, чтобы изучить видимое сочетание публикаций аккаунта в пределах снимка.
  • Сравнение вовлеченности на определенный момент: Сравнивайте видимое число лайков, комментариев, репостов и просмотров, используя collected_at, чтобы каждое наблюдение оставалось привязано ко времени сбора.

Практические советы по Rednote User Notes API

  • Используйте стабильный user_id, если он у вас уже есть: он имеет приоритет над url и исключает неоднозначность между двумя ссылками на аккаунт.
  • Передавая url, проверяйте, что имя хоста — xiaohongshu.com или xhslink.com; определенный шаблон пути не требуется.
  • Если поддерживаемый URL содержит /user/<identifier>, убедитесь, что путь указывает на нужный аккаунт, потому что этот идентификатор используется, когда user_id пуст.
  • Не добавляйте results_limit или курсор источника в запрос на отправку: каждая задача выполняет один запрос к источнику за одну страницу.
  • Используйте cursor и limit только в GET /v1/tasks/{task_id} после завершения; limit по умолчанию равен 50 и принимает значения от 1 до 500 для сохраненных результатов.
  • Считайте текст, поля автора, медиа, время публикации, хештеги, упоминания и отдельные метрики допускающими null и экранируйте публичный текст перед выводом.

Помимо Rednote User Notes API, используйте эти API, когда нужен другой тип публичных данных Rednote.

Другие платформы

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

Rednote User Notes API — FAQ

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

Укажите хотя бы одно из двух полей. Если переданы оба, приоритет у user_id; в остальных случаях используется путь /user/<identifier>, если он есть, а другой допустимый URL служит ссылкой на аккаунт.

Имя хоста после разбора должно быть xiaohongshu.com, xhslink.com или поддоменом одного из них. Эндпоинт не требует определенного пути, но значение всё равно должно указывать на нужный публичный аккаунт.

Нет. Спецификация отправки не содержит results_limit или курсора источника и выполняет один запрос к источнику. Курсорная пагинация GET /v1/tasks/{task_id} только читает записи, уже сохраненные для этой задачи.

Результат может содержать ID и публичный URL, текст, данные об авторе, медиа, published_at, collected_at, хештеги, упоминания и видимое число лайков, комментариев, репостов и просмотров. Необязательные поля источника могут быть null.

Rednote User Notes тарифицируется фиксированно: 1 кредит SocQ за задачу, а не за каждую возвращенную заметку. Число результатов не меняет настроенную плату.