Rednote User Notes
Les notes d’un utilisateur Rednote sont les publications publiques d’un compte, avec leur texte, l’attribution à l’auteur, les médias, la date de publication et les nombres d’engagement visibles. Ces champs de contenu et de contexte servent à étudier un compte, à examiner le rythme de publication, à comparer les formats et à analyser les performances à un instant donné.
Fonctionnalités de la Rednote User Notes API
- Deux entrées d’identité de compte, avec une priorité définieAccepte soit une référence d’utilisateur Rednote prise en charge, soit user_id, et retient user_id lorsque les deux champs sont fournis.
- Collecte des notes d’un compte sur une pageRécupère les notes publiques renvoyées par une seule requête source pour le compte choisi, sans exposer de curseur de source ni de limite de résultats définie par l’appelant.
- Contexte de note et d’auteur normaliséRenvoie les ID de notes, les URL publiques, le texte, l’identité de l’auteur, les références de médias, la date de publication et l’heure de collecte dans une structure PostItem cohérente.
- Instantanés d’engagement visibleConserve les nombres de mentions, de commentaires, de partages et de vues disponibles avec collected_at, pour des comparaisons bornées dans le temps.
Paramètres de la Rednote User Notes API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire (au moins un) | Référence d’utilisateur Rednote non vide dont le nom d’hôte analysé est xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux. Aucun format de chemin n’est exigé ; si l’URL contient /user/<identifier> et que user_id est vide, cet identifiant est utilisé, sinon l’URL acceptée reste la référence du compte. |
user_id | Obligatoire (au moins un) | Identifiant d’utilisateur Rednote de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou traits d’union. Fournissez url ou user_id ; si les deux sont présents, user_id explicite prévaut. |
Comment utiliser la Rednote User Notes API
Envoyez une identité de compte Rednote prise en charge, suivez la tâche asynchrone, puis parcourez les notes normalisées qu’elle a enregistrées.
- Préparez soit une URL d’utilisateur Rednote non vide sur un hôte accepté, soit un user_id valide ; laissez l’autre champ vide s’il est inutile.
- Envoyez url ou user_id en POST à /v1/rednote/user-notes et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items et suivez next_cursor tant que has_more vaut true ; ce curseur pagine les enregistrements stockés, pas d’autres pages source de 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 trueCas d’usage de la Rednote User Notes API
- Inventaire des publications d’un compte public : Servez-vous des ID de notes, des URL publiques, du texte, de l’attribution à l’auteur et de la date de publication pour cataloguer l’instantané renvoyé pour le compte.
- Examen des formats de contenu : Comparez les références d’images et de vidéos, les dimensions, les miniatures et le texte des notes disponibles parmi celles que le compte a renvoyées.
- Analyse du rythme de publication : Triez les notes par published_at et examinez ensemble texte et médias pour juger de la répartition visible des publications du compte dans l’instantané.
- Comparaison d’engagement à un instant donné : Comparez les mentions, commentaires, partages et vues visibles, en utilisant collected_at pour garder chaque observation liée à son heure de collecte.
Conseils d’expert pour la Rednote User Notes API
- Utilisez un user_id stable quand vous en avez un : il prévaut sur url et évite toute ambiguïté entre deux références de compte.
- Si vous envoyez url, vérifiez que son nom d’hôte correspond à xiaohongshu.com ou xhslink.com ; aucun format de chemin précis n’est exigé.
- Si une URL prise en charge contient /user/<identifier>, assurez-vous que le chemin désigne bien le compte voulu, car cet identifiant est utilisé quand user_id est vide.
- N’ajoutez ni results_limit ni curseur de source à la soumission : chaque tâche fait une seule requête source pour une seule page.
- N’utilisez cursor et limit que sur GET /v1/tasks/{task_id} une fois la tâche terminée ; limit vaut 50 par défaut et accepte de 1 à 500 pour les résultats enregistrés.
- Gérez le texte, les champs d’auteur, les médias, la date de publication, les hashtags, les mentions et chaque métrique comme des valeurs pouvant être nulles, et échappez le texte public avant de l’afficher.
API associées
En complément de la Rednote User Notes API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.