Rednote Note Detail
Заметки Rednote — это публичные объекты контента, которые объединяют текст и медиа с данными об авторе, ссылками на темы, временем публикации и видимой вовлеченностью. Эти поля помогают обогащать данные по известным ссылкам, проверять контент и сравнивать выбранные заметки на определенный момент времени.
Возможности Rednote Note Detail API
- Поиск заметки с проверкой токенаОбрабатывает один известный URL публичной заметки, только если допустимый хост, путь note-detail и непустой xsec_token задают полный запрос к источнику.
- Контекст заметки и автораВозвращает нормализованные идентификаторы заметки, URL источника, текст, метки времени, а также доступные ID автора, имя пользователя, отображаемое имя, URL профиля, аватар и признаки аккаунта.
- Снимок медиа и вовлеченностиСохраняет доступные ссылки на медиа, превью, размеры, длительность, ссылки на темы и видимое число лайков, комментариев, репостов и просмотров вместе со временем сбора.
Параметры Rednote Note Detail API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательный непустой URL на xiaohongshu.com, xhslink.com или их поддомене. Путь должен содержать /explore/{note_id} или /discovery/item/{note_id}, а строка запроса — непустой xsec_token. |
Как использовать Rednote Note Detail API
Укажите актуальный URL заметки с токеном, отправьте асинхронный запрос и после завершения прочитайте единственную нормализованную запись публикации.
- Скопируйте актуальный URL публичной заметки с допустимым хостом, путем note-detail и строкой запроса, содержащей непустой xsec_token.
- Отправьте url методом POST на /v1/rednote/note-detail и сохраните data.task_id из ответа на отправку.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- После успешного завершения читайте data.results.items. Запрос к источнику — это один запрос данных заметки; next_cursor лишь листает записи, сохраненные SocQ.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes
curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsСценарии использования Rednote Note Detail API
- Обогащение каталога известных заметок: Превращайте подходящий URL заметки в нормализованные идентификаторы, текст, автора, время публикации и поля источника для существующего индекса контента.
- Проверка контента выбранных заметок: Используйте текст, данные об авторе, ссылки на медиа и поля тем, чтобы изучать заданный набор отдельных публичных заметок.
- Сравнение наблюдений вовлеченности: Связывайте видимое число лайков, комментариев, репостов и просмотров с collected_at в отдельно отправленных запросах, чтобы сравнивать данные на определенный момент.
Практические советы по Rednote Note Detail API
- Используйте полный URL заметки с хостом, путем /explore/ или /discovery/item/ и параметром запроса xsec_token; голый ID заметки проверку не пройдет.
- Оставляйте xsec_token в строке запроса URL: запрос принимает только url и отклоняет отдельное поле с токеном.
- Повторно используя URL из другого результата SocQ по заметкам Rednote, убедитесь, что xsec_token в нем сохранился; Note Detail не может восстановить отсутствующий токен.
- Отправляйте один URL на задачу: у этого эндпоинта нет поля для пакетной передачи, results_limit или курсора источника.
- Считайте next_cursor только пагинацией сохраненных результатов; источник выполняет один запрос данных заметки и обычно дает не более одной записи.
- Сохраняйте поля автора, медиа, тем, меток времени и вовлеченности с осторожностью и связывайте видимые счетчики с collected_at, потому что необязательные публичные значения могут отсутствовать.
Связанные API
Помимо Rednote Note Detail API, используйте эти API, когда нужен другой тип публичных данных Rednote.