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ètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | Ré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.
- Copiez un véritable lien de partage de note Rednote sur xiaohongshu.com ou xhslink.com.
- Envoyez url en POST à /v1/rednote/note-comments 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 ; 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 trueCas 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.
API associées
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.