Rednote Comment Replies
Les réponses aux commentaires Rednote sont des réponses publiques imbriquées sous un commentaire choisi d’une note, avec leur texte, le contexte de l’auteur, les horodatages et les champs de relation ou d’engagement disponibles. Les enregistrements normalisés permettent d’examiner une branche de conversation connue sans confondre l’identifiant du commentaire source avec la pagination des résultats stockés.
Fonctionnalités de la Rednote Comment Replies API
- Référence couplée du filCiblez une branche de conversation avec à la fois l’URL publique de la note et l’identifiant du commentaire qui lui appartient.
- Capture des réponses d’une seule pageLancez une requête source et enregistrez les réponses renvoyées par cette page, sans curseur du fournisseur ni limite de résultats à l’envoi.
- Corps normalisé de la réponseLisez l’ID de la réponse, son texte public, l’URL de source, la date de publication et la date de collecte dans la structure CommentItem commune.
- Contexte public de l’auteurGardez à côté de chaque réponse l’ID de l’auteur, son nom d’utilisateur, son nom affiché, l’URL de son profil, son avatar et ses indicateurs de compte, lorsqu’ils sont disponibles.
- Relations de conversationConservez les liens parent_id et post_id disponibles ainsi que les nombres visibles de mentions « J’aime » et de réponses, pour un traitement qui tient compte du fil.
Paramètres de la Rednote Comment Replies API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL publique obligatoire dont l’hôte est xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux. Cet endpoint n’ajoute aucun motif de chemin ni règle imposant le paramètre xsec_token. |
comment_id | Obligatoire | Identifiant obligatoire du commentaire source, composé de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou tirets. |
Comment utiliser la Rednote Comment Replies API
Envoyez l’URL d’une note Rednote et l’ID d’un commentaire qui lui correspond, puis lisez le résultat d’une page de réponses via le flux de tâches asynchrone de SocQ.
- Choisissez l’URL publique d’une note xiaohongshu.com ou xhslink.com et vérifiez qu’un ID de commentaire compatible provient bien de cette même note.
- Envoyez url et comment_id en POST à /v1/rednote/comment-replies et conservez le task_id renvoyé.
- Interrogez GET /v1/tasks/{task_id} tant que la tâche est en file d’attente, en cours ou en nouvelle tentative ; arrêtez-vous sur succeeded ou failed.
- Après la réussite, lisez data.results.items et n’utilisez data.results.next_cursor que pour paginer les lignes de réponses déjà stockées par SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeededCas d’usage de la Rednote Comment Replies API
- Lecture ciblée d’une conversation : Lisez le texte et les horodatages des réponses publiques d’une seule branche de commentaire, au lieu de mélanger les réponses de toute la note.
- Enrichissement du contexte des participants : Associez à chaque réponse l’identité normalisée de son auteur, si elle est disponible, pour préparer des données de recherche sur la modération ou une revue manuelle.
- Cartographie des relations du fil : Utilisez les ID de réponses avec parent_id et post_id pour rattacher les enregistrements stockés à leur commentaire source et à leur note, lorsque ces champs sont présents.
- Instantanés des réponses à un instant donné : Conservez collected_at à côté des nombres visibles de mentions « J’aime » ou de réponses, afin que des exécutions distinctes restent des observations distinguables.
Conseils d’expert pour la Rednote Comment Replies API
- Vérifiez que comment_id appartient bien à l’URL de note envoyée ; l’endpoint valide le format de chaque champ, mais n’établit pas ce lien avant la requête source.
- Utilisez une URL complète et publique sur xiaohongshu.com, xhslink.com ou un sous-domaine accepté, même si ce validateur n’impose ni chemin de note particulier ni paramètre de requête xsec_token.
- Respectez pour comment_id le motif d’identifiant ASCII de 1 à 256 caractères, et ne le remplacez pas par un ID de base de données interne ou un ID de tâche SocQ.
- Considérez un ID de commentaire issu d’une autre collecte comme une entrée conditionnelle : les ID de commentaires normalisés sont facultatifs, confirmez donc qu’une valeur exploitable est présente avant de l’envoyer ici.
- N’ajoutez ni results_limit ni curseur de source à la charge utile d’envoi ; cet endpoint effectue une seule requête auprès du fournisseur pour une seule page source.
- Gardez le next_cursor du résultat de tâche distinct de comment_id, car ce curseur ne pagine que les lignes normalisées enregistrées après la réussite de la tâche.
- Prévoyez des champs d’identité, de relation, d’horodatage et d’indicateurs nullables, et échappez le texte public des réponses avant de l’afficher dans un autre produit.
API associées
En complément de la Rednote Comment Replies API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.