rednote/
user-profile

Récupérez un profil Rednote public à partir d’une URL de compte prise en charge ou d’un user_id, avec identité, images de profil, indicateurs de compte, nombres visibles et heure de collecte, le tout normalisé.

Rednote User Profile API

URL ou user_id
Un compte normalisé
Tâche à 1 crédit fixe
1 crédit par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Rednote User Profile

Un profil Rednote public peut exposer un identifiant de compte, un pseudo Rednote, un nom affiché, une biographie, des images de profil, un site web, des indicateurs de compte ainsi que les nombres visibles d’abonnés, d’abonnements et de publications. Un enregistrement normalisé réunit ces champs d’identité disponibles et ces signaux datés pour rapprocher des comptes, comparer des profils choisis et analyser des instantanés répétés.

Fonctionnalités de la Rednote User Profile API

  • Deux voies de recherche, avec une priorité expliciteRésout un profil à partir d’une URL Rednote prise en charge ou d’un user_id public. Si les deux champs sont fournis, c’est user_id qui sert à la recherche à la source.
  • Enregistrement d’identité publique cohérentNormalise l’ID de compte, l’URL source, le pseudo Rednote, le nom affiché, la biographie, l’avatar, l’image de couverture, le site web, l’indicateur de vérification et l’indicateur de confidentialité, lorsqu’ils sont disponibles.
  • Signaux de compte visibles et horodatésRenvoie les nombres d’abonnés, d’abonnements et de publications disponibles à côté de collected_at, pour que chaque résultat reste une observation à un instant donné et non un total en direct.

Paramètres de la Rednote User Profile API

ParamètresObligatoireDescription
urlObligatoire (au moins un)url ou user_id est obligatoire. Le nom d’hôte analysé doit être xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux. Si user_id est aussi présent, user_id est prioritaire.
user_idObligatoire (au moins un)user_id ou url est obligatoire. Utilisez de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou traits d’union. Cet identifiant explicite est prioritaire quand url est aussi fourni.

Comment utiliser la Rednote User Profile API

Envoyez une référence de compte prise en charge, suivez la tâche asynchrone, puis lisez le compte normalisé dans la page de résultats enregistrés.

  1. Préparez un user_id public à jour ou une URL dont le nom d’hôte analysé est xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux.
  2. Envoyez user_id, url ou les deux à /v1/rednote/user-profile ; si les deux sont présents, user_id est prioritaire. Conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
  4. Lisez le compte dans data.results.items. N’utilisez next_cursor que si le lecteur de résultats enregistrés indique 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

Cas d’usage de la Rednote User Profile API

  • Enrichissement de comptes connus : Transformez une référence de compte Rednote public existante en un enregistrement d’identité cohérent, avec texte de profil, images, site web et indicateurs de compte lorsqu’ils sont disponibles.
  • Comparaison d’instantanés de profils : Comparez des comptes choisis ou des collectes répétées grâce aux ID de résultat stables, à collected_at et aux nombres d’abonnés, d’abonnements et de publications disponibles au moment de la collecte.

Conseils d’expert pour la Rednote User Profile API

  • Fournissez au moins une entrée. Quand url et user_id sont tous deux présents, le backend utilise user_id et n’envoie pas l’URL à la recherche source.
  • Privilégiez user_id si vous disposez déjà de l’identifiant public du compte : vous ne dépendez plus de la structure d’une URL partagée ou d’une URL de compte.
  • Validez user_id avec ^[A-Za-z0-9:_-]{1,256}$ et exigez que le nom d’hôte analysé de l’URL corresponde à xiaohongshu.com, xhslink.com ou à un sous-domaine avant l’envoi.
  • N’ajoutez ni results_limit ni curseur de source. Cet endpoint fait une seule requête de détail, et next_cursor appartient uniquement au lecteur de résultats enregistrés de SocQ.
  • Considérez la biographie, les images de profil, le site web, les indicateurs et chaque métrique comme facultatifs. Conservez les valeurs nulles au lieu de convertir les champs manquants en chaînes vides ou en zéro.
  • Un résultat de compte Rednote antérieur peut fournir son id canonique pour user_id. Gardez cet identifiant distinct du username renvoyé, qui représente le pseudo Rednote lorsqu’il est disponible.

En complément de la Rednote User Profile API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.

Explorer d’autres plateformes

Combinez les données Rednote avec les données publiques d’autres plateformes sociales prises en charge.

Rednote User Profile API — FAQ

Rednote User Profile API récupère au plus un profil Rednote public à partir d’une URL de compte prise en charge ou d’un user_id, et renvoie un enregistrement de compte normalisé.

Utilisez user_id quand il est connu. Vous pouvez envoyer les deux champs, mais user_id explicite est prioritaire et l’URL n’est pas transmise à la recherche source.

Une URL doit avoir pour nom d’hôte xiaohongshu.com, xhslink.com ou un sous-domaine. user_id doit contenir de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou traits d’union.

Un résultat peut inclure l’ID, l’URL source, le pseudo Rednote, le nom affiché, la biographie, l’avatar, l’image de couverture, le site web, les indicateurs de vérification et de confidentialité, les nombres d’abonnés, d’abonnements et de publications, ainsi que l’heure de collecte. Certains champs peuvent valoir null.

Non. user_id est un identifiant de recherche accepté, tandis que le résultat canonique possède son propre id. username contient le pseudo Rednote quand la source le fournit ; il ne faut donc pas le substituer à user_id sans vérifier la valeur source.

Non. Une tâche fait une seule requête de détail de profil et peut enregistrer au plus un compte. La réponse commune de résultats de tâche inclut tout de même items, next_cursor et has_more pour lire les enregistrements stockés par SocQ.

Chaque tâche Rednote User Profile réussie coûte 1,00 crédit SocQ fixe. La requête n’est pas tarifée selon le nombre de champs ni le nombre de résultats enregistrés.