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, отслеживайте асинхронную задачу и читайте сохраненные нормализованные комментарии.
- Скопируйте настоящую ссылку «Поделиться» на заметку Rednote на xiaohongshu.com или xhslink.com.
- Отправьте url методом POST на /v1/rednote/note-comments и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте 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, который лишь разбивает на страницы нормализованные записи, уже сохраненные для завершенной задачи.
Связанные API
Помимо Rednote Note Comments API, используйте эти API, когда нужен другой тип публичных данных Rednote.