Rednote User Notes
Заметки пользователей Rednote — это публичные публикации аккаунта с текстом, указанием автора, медиа, временем публикации и видимым числом взаимодействий. Эти поля контента и контекста помогают изучать аккаунты, анализировать закономерности публикаций, сравнивать форматы и оценивать результативность на определенный момент времени.
Возможности Rednote User Notes API
- Два способа указать аккаунт с понятным приоритетомПринимает поддерживаемую ссылку на пользователя Rednote или user_id; если переданы оба поля, используется явно указанный user_id.
- Сбор заметок аккаунта с одной страницыПолучает публичные заметки, возвращенные одним запросом к источнику для выбранного аккаунта, без курсора источника и без лимита результатов, задаваемого вызывающей стороной.
- Нормализованный контекст заметки и автораВозвращает ID заметок, публичные URL, текст, данные об авторе, ссылки на медиа, время публикации и время сбора в единой структуре PostItem.
- Снимки видимой вовлеченностиСохраняет доступное число лайков, комментариев, репостов и просмотров вместе с collected_at для сравнения в заданных временных рамках.
Параметры Rednote User Notes API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный (хотя бы один) | Непустая ссылка на пользователя Rednote, имя хоста которой после разбора — xiaohongshu.com, xhslink.com или поддомен одного из них. Определенный шаблон пути не требуется; если URL содержит /user/<identifier>, а user_id пуст, используется этот идентификатор, иначе принятый URL остается ссылкой на аккаунт. |
user_id | Обязательный (хотя бы один) | Идентификатор пользователя Rednote длиной от 1 до 256 символов: латинские буквы ASCII, цифры, двоеточия, подчеркивания или дефисы. Укажите url или user_id; если переданы оба, приоритет у явно указанного user_id. |
Как использовать Rednote User Notes API
Отправьте один поддерживаемый идентификатор аккаунта Rednote, отслеживайте асинхронную задачу, а затем листайте сохраненные нормализованные записи заметок.
- Подготовьте непустой URL пользователя Rednote на допустимом хосте или корректный user_id; оставьте второе поле пустым, если оно не нужно.
- Отправьте url или user_id методом POST на /v1/rednote/user-notes и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте data.results.items и следуйте next_cursor, пока has_more равно true; этот курсор листает сохраненные записи, а не дополнительные страницы источника Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_USER_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Rednote User Notes API
- Опись публикаций публичного аккаунта: Используйте ID заметок, публичные URL, текст, указание автора и время публикации, чтобы каталогизировать возвращенный снимок аккаунта.
- Анализ форматов контента: Сравнивайте доступные ссылки на изображения и видео, размеры, миниатюры и текст среди возвращенных заметок аккаунта.
- Анализ закономерностей публикаций: Упорядочивайте заметки по published_at и рассматривайте текст вместе с медиа, чтобы изучить видимое сочетание публикаций аккаунта в пределах снимка.
- Сравнение вовлеченности на определенный момент: Сравнивайте видимое число лайков, комментариев, репостов и просмотров, используя collected_at, чтобы каждое наблюдение оставалось привязано ко времени сбора.
Практические советы по Rednote User Notes API
- Используйте стабильный user_id, если он у вас уже есть: он имеет приоритет над url и исключает неоднозначность между двумя ссылками на аккаунт.
- Передавая url, проверяйте, что имя хоста — xiaohongshu.com или xhslink.com; определенный шаблон пути не требуется.
- Если поддерживаемый URL содержит /user/<identifier>, убедитесь, что путь указывает на нужный аккаунт, потому что этот идентификатор используется, когда user_id пуст.
- Не добавляйте results_limit или курсор источника в запрос на отправку: каждая задача выполняет один запрос к источнику за одну страницу.
- Используйте cursor и limit только в GET /v1/tasks/{task_id} после завершения; limit по умолчанию равен 50 и принимает значения от 1 до 500 для сохраненных результатов.
- Считайте текст, поля автора, медиа, время публикации, хештеги, упоминания и отдельные метрики допускающими null и экранируйте публичный текст перед выводом.
Связанные API
Помимо Rednote User Notes API, используйте эти API, когда нужен другой тип публичных данных Rednote.