rednote/
comment-replies

Collectez une page publique de réponses sous un commentaire Rednote connu, avec texte normalisé, auteurs, relations dans le fil, horodatages et indicateurs visibles.

Rednote Comment Replies API

Commentaire connu
Réponses imbriquées
Une page source
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 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ètresObligatoireDescription
urlObligatoireURL 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_idObligatoireIdentifiant 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.

  1. 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.
  2. Envoyez url et comment_id en POST à /v1/rednote/comment-replies et conservez le task_id renvoyé.
  3. 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.
  4. 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 succeeded

Cas 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.

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.

Explorer d’autres plateformes

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

Rednote Comment Replies API — FAQ

Rednote Comment Replies API collecte une page source publique de réponses sous un commentaire Rednote connu et renvoie des champs normalisés de réponse, d’auteur, de relation, d’horodatage et d’indicateurs visibles.

url et comment_id sont tous deux obligatoires. L’URL identifie le contexte de la note Rednote publique, tandis que comment_id désigne le commentaire source dont on demande les réponses imbriquées.

Aucune règle de chemin ou de requête propre à l’endpoint n’est appliquée ici. Le validateur d’exécution exige un hôte xiaohongshu.com ou xhslink.com analysable, sous-domaines compris ; une URL formellement acceptée mais sans rapport peut tout de même échouer à la source.

Utilisez un enregistrement source public vérifié pour un commentaire de la note envoyée. Une collecte de commentaires en amont compatible peut exposer un id normalisé lorsque le fournisseur en fournit un, mais ce champ est facultatif et n’est pas garanti sur chaque enregistrement.

Un CommentItem peut contenir l’ID, la plateforme, la ressource, le type, l’URL de source, le texte public, les champs d’auteur, parent_id, post_id, les dates de publication et de collecte, ainsi que likes_count et replies_count visibles. Les champs nullables restent null lorsqu’ils sont indisponibles.

Non. Le contrat d’envoi n’accepte aucun de ces champs et effectue une seule requête source. Après la réussite, next_cursor permet de paginer les lignes déjà stockées sous la tâche SocQ, mais il ne poursuit pas la collecte chez le fournisseur.

Chaque tâche réussie coûte un montant fixe de 1 crédit SocQ, quel que soit le nombre de réponses enregistrées à partir de la page source.