rednote/
comment-replies

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

Rednote Comment Replies API

Известный комментарий
Вложенные ответы
Одна страница источника
1 кредит за запрос
Готово
Готово

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

README

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

Rednote Comment Replies

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

Возможности Rednote Comment Replies API

  • Парная ссылка на веткуУказывайте ветку обсуждения с помощью публичного URL заметки и идентификатора комментария, который к ней относится.
  • Сбор одной страницы ответовВыполняет один запрос к источнику и сохраняет ответы с этой страницы, не открывая курсор провайдера и не принимая лимит результатов при отправке.
  • Нормализованный текст ответаВозвращает ID ответа, публичный текст, исходный URL, время публикации и время сбора в общей структуре CommentItem.
  • Публичный контекст автораСохраняет рядом с каждым ответом доступные ID автора, имя пользователя, отображаемое имя, URL профиля, аватар и признаки аккаунта.
  • Связи в обсужденииСохраняет доступные ссылки parent_id и post_id вместе с видимым числом лайков и ответов для обработки с учетом структуры ветки.

Параметры Rednote Comment Replies API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательный публичный URL, хост которого — xiaohongshu.com, xhslink.com или поддомен одного из них. Этот эндпоинт не добавляет правил для шаблона пути или обязательного параметра xsec_token.
comment_idОбязательныйОбязательный идентификатор исходного комментария: от 1 до 256 символов — латинские буквы и цифры ASCII, двоеточия, подчеркивания или дефисы.

Как использовать Rednote Comment Replies API

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

  1. Выберите публичный URL заметки на xiaohongshu.com или xhslink.com и проверьте совместимый ID комментария из этой же заметки.
  2. Отправьте url и comment_id методом POST на /v1/rednote/comment-replies и сохраните возвращенный task_id.
  3. Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying; остановитесь на succeeded или failed.
  4. После успешного завершения читайте data.results.items и используйте data.results.next_cursor только для листания строк ответов, уже сохраненных в SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

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

  • Точечный анализ обсуждения: Читайте текст и временные метки публичных ответов в одной выбранной ветке комментария, не смешивая их с ответами со всей заметки.
  • Обогащение данных об участниках: Связывайте каждый ответ с доступными нормализованными данными автора при подготовке записей для исследований модерации или ручной проверки.
  • Построение карты ветки: Используйте ID ответов вместе с parent_id и post_id, чтобы снова связать сохраненные записи с исходным комментарием и заметкой, если эти поля есть.
  • Снимки ответов на определенный момент: Сохраняйте collected_at рядом с видимым числом лайков или ответов, чтобы отдельные запуски оставались различимыми наблюдениями.

Практические советы по Rednote Comment Replies API

  • Проверяйте, что comment_id относится к переданному URL заметки: эндпоинт проверяет формат каждого поля, но не проверяет эту связь до запроса к источнику.
  • Используйте полный публичный URL на xiaohongshu.com, xhslink.com или допустимом поддомене, хотя этот валидатор не требует определенного пути заметки или параметра xsec_token.
  • Соблюдайте допустимый шаблон идентификатора ASCII длиной от 1 до 256 символов для comment_id и не подставляйте вместо него внутренний ID из базы данных или ID задачи SocQ.
  • Считайте ID комментария из другого сбора условными входными данными: нормализованные ID комментариев необязательны, поэтому перед отправкой убедитесь, что пригодное значение есть.
  • Не добавляйте results_limit или курсор источника в тело запроса: этот эндпоинт выполняет один запрос к провайдеру для одной страницы источника.
  • Не путайте next_cursor результатов задачи с comment_id: этот курсор только листает нормализованные строки, сохраненные после успешного завершения задачи.
  • Допускайте значения null в полях идентификации, связей, временных меток и метрик и экранируйте текст публичных ответов перед выводом в другом продукте.

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

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

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

Rednote Comment Replies API — FAQ

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

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

Здесь не применяются правила пути или строки запроса, специфичные для эндпоинта. Валидатор во время выполнения требует корректно разбираемый хост xiaohongshu.com или xhslink.com, включая их поддомены; формально допустимый, но неподходящий URL всё равно может привести к ошибке в источнике.

Используйте проверенную публичную запись источника для комментария к переданной заметке. Совместимый предварительный сбор комментариев может вернуть нормализованный id, если провайдер его передает, но это поле необязательно и есть не в каждой записи.

CommentItem может содержать ID, platform, resource, type, исходный URL, публичный текст, поля автора, parent_id, post_id, время публикации и сбора, а также видимые likes_count и replies_count. Поля, допускающие null, остаются null, если данные недоступны.

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

Каждая успешная задача стоит фиксированно 1 кредит SocQ независимо от того, сколько ответов сохранено со страницы источника.