Retour aux API
Données publiques Rednote

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.

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’APIEntrée de départLimite de la source
Profil et notes d’un utilisateururl ou user_idUn profil ou une page source ; pas de results_limit
Détail d’une noteURL prise en charge avec chemin de note et xsec_tokenAu plus un enregistrement de note
RechercheRequête non vide et enums facultatifs pris en chargePremière page source fixe ; pas de results_limit
Commentaires et réponsesURL de note prise en charge ; les réponses exigent aussi comment_idUne page de réponse de la source
Recommandations de la page d’accueilTous les champs sont facultatifsUne 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. 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. 2. Envoyer une entrée valide

    Envoyez en POST uniquement les champs déclarés et conservez le task_id renvoyé.

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

Rechercher des notes Rednote publiques

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 success

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

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.