rednote/
user-notes

Collectez une page de notes Rednote publiques à partir d’une URL d’utilisateur prise en charge ou d’un ID d’utilisateur, avec texte, auteurs, médias, horodatages et engagement visible, le tout normalisé.

Rednote User Notes API

URL ou ID d’utilisateur
Une seule page source
Notes publiques normalisées
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 User Notes

Les notes d’un utilisateur Rednote sont les publications publiques d’un compte, avec leur texte, l’attribution à l’auteur, les médias, la date de publication et les nombres d’engagement visibles. Ces champs de contenu et de contexte servent à étudier un compte, à examiner le rythme de publication, à comparer les formats et à analyser les performances à un instant donné.

Fonctionnalités de la Rednote User Notes API

  • Deux entrées d’identité de compte, avec une priorité définieAccepte soit une référence d’utilisateur Rednote prise en charge, soit user_id, et retient user_id lorsque les deux champs sont fournis.
  • Collecte des notes d’un compte sur une pageRécupère les notes publiques renvoyées par une seule requête source pour le compte choisi, sans exposer de curseur de source ni de limite de résultats définie par l’appelant.
  • Contexte de note et d’auteur normaliséRenvoie les ID de notes, les URL publiques, le texte, l’identité de l’auteur, les références de médias, la date de publication et l’heure de collecte dans une structure PostItem cohérente.
  • Instantanés d’engagement visibleConserve les nombres de mentions, de commentaires, de partages et de vues disponibles avec collected_at, pour des comparaisons bornées dans le temps.

Paramètres de la Rednote User Notes API

ParamètresObligatoireDescription
urlObligatoire (au moins un)Référence d’utilisateur Rednote non vide dont le nom d’hôte analysé est xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux. Aucun format de chemin n’est exigé ; si l’URL contient /user/<identifier> et que user_id est vide, cet identifiant est utilisé, sinon l’URL acceptée reste la référence du compte.
user_idObligatoire (au moins un)Identifiant d’utilisateur Rednote de 1 à 256 caractères ASCII : lettres, chiffres, deux-points, tirets bas ou traits d’union. Fournissez url ou user_id ; si les deux sont présents, user_id explicite prévaut.

Comment utiliser la Rednote User Notes API

Envoyez une identité de compte Rednote prise en charge, suivez la tâche asynchrone, puis parcourez les notes normalisées qu’elle a enregistrées.

  1. Préparez soit une URL d’utilisateur Rednote non vide sur un hôte accepté, soit un user_id valide ; laissez l’autre champ vide s’il est inutile.
  2. Envoyez url ou user_id en POST à /v1/rednote/user-notes 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 et suivez next_cursor tant que has_more vaut true ; ce curseur pagine les enregistrements stockés, pas d’autres pages source de Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/user-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_USER_URL\"}"

# 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 User Notes API

  • Inventaire des publications d’un compte public : Servez-vous des ID de notes, des URL publiques, du texte, de l’attribution à l’auteur et de la date de publication pour cataloguer l’instantané renvoyé pour le compte.
  • Examen des formats de contenu : Comparez les références d’images et de vidéos, les dimensions, les miniatures et le texte des notes disponibles parmi celles que le compte a renvoyées.
  • Analyse du rythme de publication : Triez les notes par published_at et examinez ensemble texte et médias pour juger de la répartition visible des publications du compte dans l’instantané.
  • Comparaison d’engagement à un instant donné : Comparez les mentions, commentaires, partages et vues visibles, en utilisant collected_at pour garder chaque observation liée à son heure de collecte.

Conseils d’expert pour la Rednote User Notes API

  • Utilisez un user_id stable quand vous en avez un : il prévaut sur url et évite toute ambiguïté entre deux références de compte.
  • Si vous envoyez url, vérifiez que son nom d’hôte correspond à xiaohongshu.com ou xhslink.com ; aucun format de chemin précis n’est exigé.
  • Si une URL prise en charge contient /user/<identifier>, assurez-vous que le chemin désigne bien le compte voulu, car cet identifiant est utilisé quand user_id est vide.
  • N’ajoutez ni results_limit ni curseur de source à la soumission : chaque tâche fait une seule requête source pour une seule page.
  • N’utilisez cursor et limit que sur GET /v1/tasks/{task_id} une fois la tâche terminée ; limit vaut 50 par défaut et accepte de 1 à 500 pour les résultats enregistrés.
  • Gérez le texte, les champs d’auteur, les médias, la date de publication, les hashtags, les mentions et chaque métrique comme des valeurs pouvant être nulles, et échappez le texte public avant de l’afficher.

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

Rednote User Notes API collecte une page de notes publiques à partir d’une URL d’utilisateur Rednote prise en charge ou d’un ID d’utilisateur, et renvoie l’identité normalisée de la note, le texte, le contexte de l’auteur, les médias, les horodatages et les champs d’engagement visibles.

Fournissez au moins un des deux champs. Si les deux sont présents, user_id prévaut ; sinon un chemin /user/<identifier> est résolu lorsqu’il existe, et toute autre URL acceptée sert de référence du compte.

Le nom d’hôte analysé doit être xiaohongshu.com, xhslink.com ou un sous-domaine de l’un des deux. L’endpoint n’exige aucun chemin particulier, mais la valeur doit tout de même désigner le compte public voulu.

Non. La spécification de soumission n’a ni results_limit ni curseur de source, et effectue une seule requête source. La pagination par curseur de GET /v1/tasks/{task_id} ne lit que les enregistrements déjà stockés pour cette tâche.

Un résultat peut contenir son ID et son URL publique, le texte, l’identité de l’auteur, les médias, published_at, collected_at, les hashtags, les mentions et les nombres visibles de mentions, de commentaires, de partages et de vues. Les champs source facultatifs peuvent valoir null.

Rednote User Notes applique une facturation fixe de 1 crédit SocQ par tâche, et non par note renvoyée. Le nombre de résultats ne modifie pas le tarif configuré.