Rednote User Profile
Публичные профили Rednote могут содержать идентификатор аккаунта, имя пользователя Rednote, отображаемое имя, описание профиля, изображения профиля, сайт, признаки аккаунта и видимое число подписчиков, подписок и публикаций. Нормализованная запись хранит эти доступные данные об идентичности вместе с показателями на момент сбора, чтобы сопоставлять аккаунты, сравнивать выбранные профили и анализировать повторные снимки.
Возможности Rednote User Profile API
- Два способа поиска с явным приоритетомНаходит один профиль по поддерживаемому URL Rednote или публичному user_id. Если переданы оба поля, для запроса к источнику используется явно указанный user_id.
- Единая запись публичных данных аккаунтаНормализует доступные ID аккаунта, URL источника, имя пользователя Rednote, отображаемое имя, описание профиля, аватар, обложку, сайт, признак верификации и признак приватности.
- Видимые показатели аккаунта с меткой времениВозвращает доступное число подписчиков, подписок и публикаций рядом с collected_at, чтобы каждый результат оставался наблюдением на определенный момент, а не итогом в реальном времени.
Параметры Rednote User Profile API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный (хотя бы один) | Обязательно одно из полей: url или user_id. Имя хоста после разбора должно быть xiaohongshu.com, xhslink.com или поддоменом одного из них. Если также передан user_id, приоритет у user_id. |
user_id | Обязательный (хотя бы один) | Обязательно одно из полей: user_id или url. Используйте от 1 до 256 символов: латинские буквы ASCII, цифры, двоеточия, подчеркивания или дефисы. Этот явный идентификатор имеет приоритет, если передан и url. |
Как использовать Rednote User Profile API
Отправьте одну поддерживаемую ссылку на аккаунт, отслеживайте асинхронную задачу и прочитайте нормализованный аккаунт со страницы сохраненных результатов.
- Подготовьте актуальный публичный user_id или URL, имя хоста которого после разбора — xiaohongshu.com, xhslink.com или поддомен одного из них.
- Отправьте user_id, url или оба поля на /v1/rednote/user-profile; если переданы оба, приоритет у user_id. Сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Прочитайте аккаунт в data.results.items. Используйте next_cursor, только если модуль чтения сохраненных результатов сообщает has_more равным true.
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueСценарии использования Rednote User Profile API
- Обогащение известных аккаунтов: Превращайте имеющуюся ссылку на публичный аккаунт Rednote в единую запись с доступным текстом профиля, изображениями, сайтом и признаками аккаунта.
- Сравнение снимков профиля: Сравнивайте выбранные аккаунты или повторные сборы по стабильным ID результатов, collected_at и числу подписчиков, подписок и публикаций, доступному на момент сбора.
Практические советы по Rednote User Profile API
- Передайте хотя бы одно поле. Если указаны и url, и user_id, бэкенд использует явный user_id и не передает URL в запрос к источнику.
- Предпочитайте user_id, если публичный идентификатор аккаунта уже известен: так вы не зависите от структуры ссылки «Поделиться» или URL аккаунта.
- Перед отправкой проверяйте user_id выражением ^[A-Za-z0-9:_-]{1,256}$ и требуйте, чтобы имя хоста URL после разбора совпадало с xiaohongshu.com, xhslink.com или их поддоменом.
- Не добавляйте results_limit или курсор источника. Этот эндпоинт выполняет один запрос данных профиля, а next_cursor относится только к модулю чтения сохраненных результатов SocQ.
- Считайте описание профиля, изображения, сайт, признаки и все метрики необязательными. Сохраняйте null, а не превращайте отсутствующие поля в пустые строки или ноль.
- Предыдущий результат по аккаунту Rednote может дать канонический id для user_id. Не путайте этот идентификатор с возвращаемым username, который содержит доступное имя пользователя Rednote.
Связанные API
Помимо Rednote User Profile API, используйте эти API, когда нужен другой тип публичных данных Rednote.