rednote/
note-detail

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

Rednote Note Detail API

URL заметки с токеном
Данные одной заметки
Нормализованная запись
1 кредит за запрос
Готово
Готово

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

README

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

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 заметки с токеном, отправьте асинхронный запрос и после завершения прочитайте единственную нормализованную запись публикации.

  1. Скопируйте актуальный URL публичной заметки с допустимым хостом, путем note-detail и строкой запроса, содержащей непустой xsec_token.
  2. Отправьте url методом POST на /v1/rednote/note-detail и сохраните data.task_id из ответа на отправку.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. После успешного завершения читайте 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, потому что необязательные публичные значения могут отсутствовать.

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

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

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

Rednote Note Detail API — FAQ

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

Используйте непустой URL на xiaohongshu.com, xhslink.com или их поддомене. Путь должен содержать /explore/{note_id} или /discovery/item/{note_id}, а строка запроса — непустой xsec_token.

Нет. Публичная схема запроса принимает только url; SocQ извлекает note_id и xsec_token из этого URL.

Отправьте актуальный URL публичной заметки, который уже содержит xsec_token. URL, возвращенный другим эндпоинтом SocQ для заметок Rednote, можно использовать повторно, только если этот параметр запроса в нем сохранился; Note Detail не создает отсутствующий токен.

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

Нет. Источник выполняет один запрос данных заметки и сохраняет не более одной записи. Общий модуль чтения задач по-прежнему предоставляет limit, next_cursor и has_more для записей, сохраненных SocQ.

Для эндпоинта настроена фиксированная цена 1,00 кредита SocQ за задачу. Оценка стоимости не зависит от числа возвращенных записей.