Rednote Public Data APIs
Récupérez des profils et des notes publics, recherchez des notes ou des utilisateurs, collectez les commentaires et leurs réponses imbriquées, et capturez une page de recommandations de la page d’accueil.
API Rednote disponibles
Huit API couvrent les cas d’usage de profils, de notes, de commentaires, de réponses, de recherche et de recommandations.

rednote/comment-replies
Commentaires1 crédit par requête

rednote/home-recommendations
Publications1 crédit par requête

rednote/note-comments
Commentaires1 crédit par requête

rednote/note-detail
Publications1 crédit par requête

rednote/search-notes
Recherche1 crédit par requête

rednote/search-users
Recherche1 crédit par requête

rednote/user-notes
Publications1 crédit par requête

rednote/user-profile
Profils1 crédit par requête
Quelles données Rednote pouvez-vous récupérer ?
Le catalogue Rednote renvoie des enregistrements normalisés de comptes, de publications et de commentaires issus de sources publiques.
Profils et notes d’un utilisateur
Résolvez un profil public ou collectez une page source de notes à partir d’une URL de compte prise en charge ou d’un user_id.
Détail des notes et découverte
Récupérez une note à partir d’une URL contenant son jeton, recherchez des notes avec les filtres pris en charge ou collectez une page de recommandations.
Recherche d’utilisateurs
Recherchez parmi la première page source fixe de comptes publics avec une requête non vide.
Commentaires et réponses
Collectez une page de commentaires publics pour une note, ou une page de réponses pour un ID de commentaire connu.
Spécifications des API Rednote en un coup d’œil
Chaque endpoint repose sur une requête source bornée et rejette les paramètres non déclarés.
| Groupe d’API | Entrée de départ | Limite de la source |
|---|---|---|
| Profil et notes d’un utilisateur | url ou user_id | Un profil ou une page source ; pas de results_limit |
| Détail d’une note | URL prise en charge avec chemin de note et xsec_token | Au plus un enregistrement de note |
| Recherche | Requête non vide et enums facultatifs pris en charge | Première page source fixe ; pas de results_limit |
| Commentaires et réponses | URL de note prise en charge ; les réponses exigent aussi comment_id | Une page de réponse de la source |
| Recommandations de la page d’accueil | Tous les champs sont facultatifs | Une page avec results_limit de 1–40, 20 par défaut |
Fonctionnement des API Rednote
Les huit endpoints suivent le même flux asynchrone : envoi, interrogation, puis lecture des résultats stockés.
1. Choisir l’endpoint
Sélectionnez l’endpoint de profil, de note, de recherche, de commentaires, de réponses ou de recommandations adapté à votre tâche sur données publiques.
2. Envoyer une entrée valide
Envoyez en POST uniquement les champs déclarés et conservez le task_id renvoyé.
3. Lire les résultats normalisés
Interrogez la tâche jusqu’à un état final, puis lisez data.results.items et n’utilisez next_cursor que pour paginer les résultats stockés.
Authentifiez-vous avec une clé API SocQ et envoyez une requête accompagnée des filtres facultatifs pris en charge. Chaque tâche Rednote réussie coûte un montant fixe de 1 crédit.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"travel guide","sort_by":"general","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successCas d’usage courants de l’API Rednote
Recherche sur les créateurs et leurs contenus
Associez l’identité d’un compte public à une page bornée des notes qu’il a publiées.
Repérage de sujets
Comparez la recherche de notes, la recherche d’utilisateurs et les instantanés de recommandations, avec leurs horodatages de collecte.
Lecture des conversations
Examinez les commentaires d’une note publique et les réponses imbriquées d’un commentaire choisi sous forme d’enregistrements normalisés.
Limites et politique sur les données publiques
Ces endpoints lisent des données publiques via des requêtes source bornées et ne proposent ni actions sur les comptes ni accès privé.
- Les hôtes d’URL pris en charge sont xiaohongshu.com, xhslink.com et leurs sous-domaines ; Note Detail exige en plus un chemin /explore/{id} ou /discovery/item/{id} et un xsec_token non vide.
- user_id et comment_id acceptent de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou tirets.
- Search Notes n’accepte sort_by, media_type et published_within que parmi les valeurs d’enum listées ; Search Users n’accepte que query.
- Seul Home Recommendations accepte results_limit, de 1–40, avec 20 par défaut.
- Chaque tâche Rednote réussie coûte un montant fixe de 1 crédit.
Questions fréquentes sur l’API Rednote
Que sont les API Rednote ?
Les API Rednote récupèrent des profils, notes, commentaires, réponses imbriquées, résultats de recherche et recommandations de la page d’accueil publics, sous forme d’enregistrements normalisés.
Quel endpoint accepte results_limit ?
Seul Home Recommendations accepte results_limit, sous forme d’entier de 1 à 40. Les autres endpoints Rednote le rejettent.
Note Detail accepte-t-il n’importe quelle URL Rednote ?
Non. Il exige un hôte accepté, un chemin /explore/{id} ou /discovery/item/{id} et une valeur xsec_token non vide dans la chaîne de requête.
Comment les requêtes Rednote sont-elles facturées ?
Chaque tâche réussie coûte un montant fixe de 1 crédit SocQ.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
Kwai API
Récupérez des profils Kwai publics, une page de publications d’un compte ou une publication connue, avec identité, contenu, médias, horodatages et engagement visible normalisés.
Truth Social API
Récupérez les détails d’un compte public, collectez une page source de publications d’un compte ou transformez l’URL d’une publication connue en enregistrements normalisés.
Google Ad Library API
Découvrez des annonceurs publics, collectez les créations d’une entreprise ou récupérez par URL une création connue du Transparency Center, pour la recherche et la vérification.
Google Maps API
Découvrez des lieux publics, récupérez des détails normalisés à partir d’URL Maps connues et collectez des avis publics avec le contexte du lieu et de l’auteur relié à la source.
Amazon API
Recherchez des produits Amazon publics et collectez des détails de produits, Best Sellers, avis, profils de vendeurs et vitrines de créateurs normalisés sur les places de marché prises en charge.
Apple App Store API
Collectez les détails d’applications, les classements par catégorie et les avis publics de l’Apple App Store à partir d’URL connues de la boutique, sous forme d’enregistrements d’applications et d’avis normalisés.