Rednote Note Detail
Les notes Rednote sont des contenus publics qui associent texte et médias à l’identité de l’auteur, à des références de sujets, à une date de publication et à un engagement visible. Ces champs permettent d’enrichir des liens déjà connus, d’examiner du contenu et de comparer, à un instant donné, une sélection de notes.
Fonctionnalités de la Rednote Note Detail API
- Recherche de note par URL à jetonRésout une URL de note publique connue, à condition que l’hôte accepté, le chemin de détail de note et un xsec_token non vide désignent une recherche source complète.
- Contexte de la note et de l’auteurRenvoie l’identité normalisée de la note, l’URL source, le texte, les horodatages ainsi que l’ID, le nom d’utilisateur, le nom affiché, l’URL de profil, l’avatar et les indicateurs de compte de l’auteur lorsqu’ils sont disponibles.
- Médias et instantané d’engagementGarde avec l’heure de collecte les références de médias disponibles, les aperçus, les dimensions, la durée, les références de sujets et les nombres visibles de mentions, de commentaires, de partages et de vues.
Paramètres de la Rednote Note Detail API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL obligatoire et non vide sur xiaohongshu.com, xhslink.com ou l’un de leurs sous-domaines. Son chemin doit inclure /explore/{note_id} ou /discovery/item/{note_id}, et sa chaîne de requête doit contenir un xsec_token non vide. |
Comment utiliser la Rednote Note Detail API
Fournissez une URL de note à jeton encore valide, envoyez la requête asynchrone, puis lisez la publication normalisée une fois la tâche terminée.
- Copiez l’URL d’une note publique récente dont l’hôte accepté, le chemin de détail de note et la chaîne de requête incluent un xsec_token non vide.
- Envoyez url en POST à /v1/rednote/note-detail et conservez data.task_id dans la réponse de soumission.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou signale un échec.
- Lisez data.results.items après le succès. La recherche à la source est une requête de détail unique ; next_cursor ne fait que paginer les enregistrements stockés par SocQ.
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes
curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"url\":\"$REDNOTE_NOTE_URL\"}"
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsCas d’usage de la Rednote Note Detail API
- Compléter un catalogue de notes connues : Transformez l’URL d’une note qualifiée en identité, texte, auteur, date de publication et champs sources normalisés pour un index de contenus existant.
- Examiner le contenu de notes choisies : Appuyez-vous sur le texte, le contexte d’auteur, les références de médias et les champs de sujets pour inspecter un ensemble défini de notes publiques.
- Comparer des relevés d’engagement : Associez les nombres visibles de mentions, de commentaires, de partages et de vues à collected_at, sur plusieurs recherches soumises séparément, pour comparer des états à un instant donné.
Conseils d’expert pour la Rednote Note Detail API
- Utilisez l’URL complète de la note, avec son hôte, son chemin /explore/ ou /discovery/item/ et le paramètre de requête xsec_token : un simple ID de note ne passe pas la validation.
- Laissez xsec_token dans la chaîne de requête de l’URL, car la requête n’accepte que url et rejette un champ de jeton séparé.
- Si vous réutilisez l’URL d’un autre résultat de note Rednote de SocQ, vérifiez que xsec_token y figure toujours : Note Detail ne peut pas reconstituer un jeton manquant.
- Envoyez une URL par tâche, car cet endpoint de détail n’offre ni champ de lot, ni results_limit, ni curseur de source.
- Considérez next_cursor comme une pagination des résultats stockés uniquement : la source effectue une seule recherche de détail et produit normalement au plus un enregistrement.
- Stockez de façon défensive les champs d’auteur, de médias, de sujets, d’horodatage et d’engagement, et associez les compteurs visibles à collected_at, car des valeurs publiques facultatives peuvent manquer.
API associées
En complément de la Rednote Note Detail API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Rednote.