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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire (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_id | Obligatoire (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.
- 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.
- 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é.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- 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 trueCas 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.
API associées
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.