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.
- Выберите публичный URL заметки на xiaohongshu.com или xhslink.com и проверьте совместимый ID комментария из этой же заметки.
- Отправьте url и comment_id методом POST на /v1/rednote/comment-replies и сохраните возвращенный task_id.
- Опрашивайте GET /v1/tasks/{task_id}, пока задача находится в статусе queued, running или retrying; остановитесь на succeeded или failed.
- После успешного завершения читайте 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 в полях идентификации, связей, временных меток и метрик и экранируйте текст публичных ответов перед выводом в другом продукте.
Связанные API
Помимо Rednote Comment Replies API, используйте эти API, когда нужен другой тип публичных данных Rednote.