rednote/
note-comments

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

Rednote Note Comments API

URL заметки на входе
Один запрос к источнику
Нормализованные комментарии
1 кредит за запрос
Готово
Готово

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

README

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

Rednote Note Comments

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

Возможности Rednote Note Comments API

  • Гибкий ввод ссылок RednoteПередайте одну ссылку на xiaohongshu.com, xhslink.com или их поддомене; проверка note-comments не требует определенного пути, строки запроса или xsec_token.
  • Стабильные записи комментариевПолучайте ID комментариев, текст, URL источника, метки времени и доступные данные об авторе в нормализованной структуре результата CommentItem 1.0.
  • Связи с заметкой и веткойСохраняет post_id и parent_id, если они переданы, чтобы возвращенные комментарии оставались связаны со своей заметкой и доступным родительским контекстом.
  • Поля вовлеченности на момент сбораХранит доступные likes_count и replies_count рядом с collected_at, не превращая отсутствующие значения в ноль и не подразумевая полного охвата ответов.

Параметры Rednote Note Comments API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательная непустая ссылка. Проверка при выполнении принимает xiaohongshu.com, xhslink.com и их поддомены, не проверяя путь и не требуя xsec_token; используйте настоящую ссылку «Поделиться» на заметку, чтобы поставщик смог определить нужную заметку.

Как использовать Rednote Note Comments API

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

  1. Скопируйте настоящую ссылку «Поделиться» на заметку Rednote на xiaohongshu.com или xhslink.com.
  2. Отправьте url методом POST на /v1/rednote/note-comments и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items; следуйте next_cursor, только пока has_more равно true, чтобы листать сохраненные результаты задачи.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://xhslink.com/{share_code}"}'

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

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

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

Практические советы по Rednote Note Comments API

  • Используйте полную ссылку «Поделиться», скопированную для нужной заметки: прохождение проверки имени хоста само по себе не гарантирует, что поставщик сможет обработать посторонний путь.
  • Не придумывайте xsec_token и не требуйте его отдельно. Это правило относится к спецификации note-detail, а не к rednote/note-comments.
  • Не отправляйте results_limit или курсор поставщика: запрос на отправку содержит только url и выполняет один запрос к источнику.
  • Считайте parent_id, post_id, метки времени, атрибуты автора и метрики полями источника, которые могут быть null, а не гарантированными значениями.
  • Отделяйте глубину сбора из источника от next_cursor, который лишь разбивает на страницы нормализованные записи, уже сохраненные для завершенной задачи.

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

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

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

Rednote Note Comments API — FAQ

Rednote Note Comments API собирает одну страницу ответа источника с публичными комментариями, связанными с указанной ссылкой на заметку Rednote.

При выполнении требуется один непустой url, имя хоста которого после разбора — xiaohongshu.com, xhslink.com или их поддомен. Определенный путь или строка запроса не проверяются, но для осмысленной обработки у поставщика нужна настоящая ссылка «Поделиться» на заметку.

Нет. rednote/note-comments применяет только общую проверку имени хоста Rednote. Более строгие проверки пути и xsec_token относятся к отдельной спецификации note-detail.

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

Общий модуль чтения результатов задач может листать записи CommentItem, уже сохраненные успешной задачей. Этот непрозрачный курсор SocQ не запрашивает еще одну страницу источника Rednote.

Успешная задача Rednote Note Comments стоит фиксированные 1,00 кредита SocQ независимо от числа комментариев, возвращенных единственным запросом к источнику.