rednote/
user-profile

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

Rednote User Profile API

URL или user_id
Один нормализованный аккаунт
1 кредит за задачу
1 кредит за запрос
Готово
Готово

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

README

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

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

Отправьте одну поддерживаемую ссылку на аккаунт, отслеживайте асинхронную задачу и прочитайте нормализованный аккаунт со страницы сохраненных результатов.

  1. Подготовьте актуальный публичный user_id или URL, имя хоста которого после разбора — xiaohongshu.com, xhslink.com или поддомен одного из них.
  2. Отправьте user_id, url или оба поля на /v1/rednote/user-profile; если переданы оба, приоритет у user_id. Сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Прочитайте аккаунт в 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.

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

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

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

Rednote User Profile API — FAQ

Rednote User Profile API получает не более одного публичного профиля Rednote по поддерживаемому URL аккаунта или user_id и возвращает нормализованную запись аккаунта.

Используйте user_id, если он известен. Можно передать оба поля, но приоритет у явного user_id, и URL в запрос к источнику не передается.

URL после разбора должен указывать на xiaohongshu.com, xhslink.com или их поддомен. user_id должен содержать от 1 до 256 символов: латинские буквы ASCII, цифры, двоеточия, подчеркивания или дефисы.

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

Нет. user_id — это допустимый идентификатор для поиска, а у канонического результата есть собственный id. username содержит имя пользователя Rednote, если источник его передает, поэтому не подставляйте его вместо user_id, не проверив значение источника.

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

Каждая успешная задача Rednote User Profile стоит фиксированные 1,00 кредита SocQ. Стоимость запроса не зависит от числа полей или сохраненных результатов.