rednote/
note-comments

Collectez une page de commentaires Rednote publics à partir de l’URL d’une note xiaohongshu.com ou xhslink.com, avec texte, auteurs, horodatages, références de la note et engagement visible.

Rednote Note Comments API

URL de note en entrée
Une seule requête source
Commentaires normalisés
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 Note Comments

Les commentaires d’une note Rednote sont des réponses publiques rattachées à une note précise ; ils peuvent comprendre le texte de la réponse, l’identité de l’auteur, l’heure de publication, la référence du fil et les nombres d’interactions visibles. Ils permettent aux chercheurs de conserver ce que les gens ont écrit autour d’une note choisie, tout en gardant chaque observation liée à sa source et à son heure de collecte.

Fonctionnalités de la Rednote Note Comments API

  • Entrée souple par lien de partage RednoteEnvoyez une référence hébergée sur xiaohongshu.com, xhslink.com ou l’un de leurs sous-domaines ; le validateur de note-comments n’impose ni chemin précis, ni chaîne de requête, ni xsec_token.
  • Enregistrements de commentaires stablesRecevez les ID de commentaires, le texte, les URL sources, les horodatages et l’identité de l’auteur lorsqu’elle est disponible, dans la structure normalisée CommentItem 1.0.
  • Références de note et de filConserve post_id et parent_id lorsqu’ils sont fournis, pour que les commentaires renvoyés restent rattachés à leur note et au contexte parent disponible.
  • Champs d’engagement à un instant donnéGarde les likes_count et replies_count disponibles à côté de collected_at, sans transformer une valeur manquante en zéro ni laisser croire que toutes les réponses sont couvertes.

Paramètres de la Rednote Note Comments API

ParamètresObligatoireDescription
urlObligatoireRéférence obligatoire et non vide. La validation à l’exécution accepte xiaohongshu.com, xhslink.com et leurs sous-domaines sans imposer de chemin ni exiger xsec_token ; utilisez un véritable lien de partage de note afin que le fournisseur puisse résoudre la note visée.

Comment utiliser la Rednote Note Comments API

Envoyez un lien de note Rednote pris en charge, suivez la tâche asynchrone, puis lisez les commentaires normalisés qu’elle a enregistrés.

  1. Copiez un véritable lien de partage de note Rednote sur xiaohongshu.com ou xhslink.com.
  2. Envoyez url en POST à /v1/rednote/note-comments et 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 data.results.items ; suivez next_cursor uniquement quand has_more vaut true pour parcourir les résultats enregistrés de la tâche.
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://xhslink.com/{share_code}"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Rednote Note Comments API

  • Codage qualitatif des réactions : Relisez le texte public renvoyé et le contexte d’auteur disponible pour classer les questions, les réactions ou les thèmes de discussion récurrents autour d’une note choisie.
  • Archives de commentaires reliées à leur source : Gardez les ID de commentaires, les URL sources, post_id, parent_id, published_at et collected_at pour des dossiers de recherche traçables.
  • Revue d’un instantané d’engagement : Comparez les nombres de mentions et de réponses disponibles entre les commentaires renvoyés, en rattachant chaque observation à son heure de collecte.

Conseils d’expert pour la Rednote Note Comments API

  • Utilisez le lien de partage complet copié pour la note visée : un nom d’hôte valide ne garantit pas que le fournisseur sache résoudre un chemin sans rapport.
  • N’inventez pas xsec_token et ne l’exigez pas à part. Cette règle relève de la spécification de note-detail, pas de rednote/note-comments.
  • N’envoyez ni results_limit ni curseur du fournisseur : la requête ne porte que url et déclenche une seule requête source.
  • Traitez parent_id, post_id, les horodatages, les attributs d’auteur et les métriques comme des champs source pouvant être nuls, pas comme des valeurs garanties.
  • Distinguez la profondeur de collecte à la source de next_cursor, qui ne pagine que les enregistrements normalisés déjà stockés pour une tâche terminée.

En complément de la Rednote Note Comments 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 Note Comments API — FAQ

Rednote Note Comments API collecte une page de réponse de la source contenant les commentaires publics associés à un lien de note Rednote donné.

L’exécution exige un seul url non vide dont le nom d’hôte analysé est xiaohongshu.com, xhslink.com ou l’un de leurs sous-domaines. Aucun chemin ni paramètre précis n’est imposé, mais un véritable lien de partage de note reste nécessaire pour que le fournisseur résolve correctement la note.

Non. rednote/note-comments n’applique que le validateur de nom d’hôte commun à Rednote. Les contrôles plus stricts du chemin et de xsec_token concernent la spécification distincte de note-detail.

Non. La spécification de soumission n’accepte que url, et l’intégration du fournisseur effectue une seule requête source, sans pagination de la source pilotée par l’appelant.

Le lecteur de résultats de tâche, commun à tous les endpoints, peut parcourir les enregistrements CommentItem déjà stockés par une tâche réussie. Ce curseur SocQ opaque ne demande pas une autre page de source à Rednote.

Une tâche Rednote Note Comments réussie coûte 1,00 crédit SocQ, quel que soit le nombre de commentaires renvoyés par la requête source unique.