Skip to main content

API de réseaux sociaux

API Rednote

Lisez les notes Rednote, les profils, les commentaires imbriqués, la recherche, les mots-clés tendance, le fil d’accueil et les fiches produits avec leurs avis, sous forme de JSON structuré.

  • Série App V2 recommandée — la surface la plus récente, la plus stable et la plus complète
  • Des signaux de tendance issus de la plateforme qui façonne les goûts chinois en beauté, mode et voyage
  • Fiches produits, avis et commentaires à intention d’achat pour la recherche e-commerce

$0.05 de crédit offert à l'inscription · sans carte bancaire · à partir de $0.01/requête

Une requête, du JSON structuré

terminal
1curl -X GET "https://api.tikhub.io/api/v1/xiaohongshu/app_v2/get_image_note_detail?note_id=65a1b2c3d4e5f60001234567" \
2 -H "Authorization: Bearer YOUR_API_KEY"
response.json
1{
2 "code": 200,
3 "data": {
4 "note_id": "65a1b2c3d4e5f60001234567",
5 "title": "示例笔记标题",
6 "type": "normal",
7 "interact_info": {
8 "liked_count": 18400,
9 "comment_count": 920,
10 "collected_count": 7600,
11 "share_count": 340
12 },
13 "user": { "user_id": "5f1a2b3c", "nickname": "用户昵称", "red_id": "xhs_id" },
14 "image_list": [{ "url": "https://..." }],
15 "tag_list": [{ "name": "美妆" }]
16 }
17}

Obtenez votre clé API sur user.tikhub.io/dashboard/api — ou suivez le guide de démarrage.

RapidePaiement à l'usageJusqu'à des millions99.9% de disponibilitéBien documentéeSans revue d'app

Ce que contient l'API Rednote

L’API Rednote de TikHub lit la plateforme qui définit les goûts des consommateurs chinois en beauté, mode, cuisine et voyage. Extrayez les détails des notes, les profils utilisateurs, les commentaires imbriqués, les résultats de recherche, les mots-clés tendance, le fil d’accueil et les fiches produits avec leurs avis sous forme de JSON structuré — commencez par la série App V2 recommandée.

API Rednote App V2 (recommandée)

Détail des notes image et vidéoInfos utilisateur et notes publiées/favoritesCommentaires et sous-commentairesRecherche : notes/utilisateurs/images/produitsInfos et fil d’un sujetProduits, avis et recommandationsFil d’inspiration créateurs

API Rednote PGY

Données clés et synthèse d’un blogueurPortraits et historique des abonnésNotes et performance d’un blogueurListe de découverte de blogueursDétail des notes commerciales

API Rednote Web V3

Détail d’une noteCommentaires et sous-commentairesRecherche de notes/utilisateursMots-clés tendance et suggestionsFil d’accueil et catégoriesProfil et notes d’un utilisateur

Les anciennes séries App V1 (/xiaohongshu/app/), Web (/xiaohongshu/web/) et Web V2 sont dépréciées. Construisez sur les trois séries maintenues : App V2 (recommandée), PGY (marketing créateurs) et Web V3.

Là où les goûts des consommateurs chinois se décident en premier

Rednote est l’endroit où naissent en Chine les tendances beauté, mode, cuisine et voyage avant d’atteindre l’Occident. TikHub vous en donne les surfaces application et web — y compris les mots-clés tendance, le fil d’accueil et les fiches produits avec leurs commentaires à intention d’achat — pour lire la demande à sa source, et non son écho.

TikHubOutils génériques
Mots-clés tendance et fil d’accueil
Fiches produits et avis
Fils de commentaires imbriqués
Séries App V2, PGY et Web V3

Endpoints de l'API Rednote

Une référence des endpoints Rednote les plus utilisés. Parcourez l'ensemble complet dans la référence API ou la documentation.

API Rednote App V2 (recommandée — stable)

App V2 est la valeur par défaut recommandée — la série la plus récente, la plus stable et la plus complète, avec les produits, les avis, les sujets et le fil d’inspiration créateurs. Facturée $0.01 par requête ; chaque réponse inclut une cache_url valable 24 h (réaccès gratuit). Rednote est une série particulière — lisez le guide d’utilisation sur blog.tikhub.io/zh/article/7 avant d’intégrer.

Cas d'usageEndpointDocs
Récupérer le détail d’une note image/api/v1/xiaohongshu/app_v2/get_image_note_detail
Récupérer le détail d’une note vidéo/api/v1/xiaohongshu/app_v2/get_video_note_detail
Récupérer les commentaires d’une note/api/v1/xiaohongshu/app_v2/get_note_comments
Récupérer les sous-commentaires d’une note/api/v1/xiaohongshu/app_v2/get_note_sub_comments

API Rednote PGY (marketing créateurs)

PGY (蒲公英 / Pugongying) est la plateforme officielle de marketing créateurs de Rednote. Cette série renvoie les analyses des blogueurs — données clés et synthèses, portraits et historique des abonnés, performance des notes et découverte de blogueurs — soit les données dont les marques se servent pour qualifier des influenceurs avant une campagne.

Cas d'usageEndpointDocs
Récupérer le détail d’un blogueur/api/v1/xiaohongshu/pgy/get_blogger_detail
Récupérer les données clés d’un blogueur/api/v1/xiaohongshu/pgy/get_blogger_core_data
Récupérer la synthèse des données d’un blogueur/api/v1/xiaohongshu/pgy/get_blogger_data_summary
Récupérer le portrait des abonnés/api/v1/xiaohongshu/pgy/get_blogger_fans_profile

API Rednote Web V3

Web V3 sert de surface alternative — utile pour les mots-clés tendance, les suggestions de recherche et le fil de recommandations de la page d’accueil. Les anciennes séries Web V2 et Web ne sont plus maintenues ; évitez-les.

Cas d'usageEndpointDocs
Récupérer le détail d’une note (publication)/api/v1/xiaohongshu/web_v3/fetch_note_detail
Récupérer les commentaires d’une note/api/v1/xiaohongshu/web_v3/fetch_note_comments
Récupérer les sous-commentaires/api/v1/xiaohongshu/web_v3/fetch_sub_comments
Rechercher des notes par mot-clé/api/v1/xiaohongshu/web_v3/fetch_search_notes

Astuces et dépannage

Des notes opérationnelles tirées du terrain pour exploiter les données Rednote en production.

À LIRE ABSOLUMENT — Rednote est une série particulière

Rednote (小红书) est la série la plus pleine de subtilités chez TikHub : consultez le guide d’utilisation officiel avant d’utiliser N’IMPORTE QUEL endpoint. En résumé : App V2 pour le contenu, PGY pour les analyses de marketing créateurs, Web V3 pour le fil d’accueil et les tendances. N’utilisez PAS les anciennes séries App V1 (/xiaohongshu/app/), Web ou Web V2 — elles sont dépréciées.

Lire le guide d’utilisation Rednote

Quelle série utiliser

App V2 est la valeur par défaut recommandée — la série la plus récente, la plus stable et la plus complète (notes, utilisateurs, recherche, produits, sujets, inspiration créateurs). PGY couvre les analyses de marketing créateurs (données de blogueurs, portraits d’abonnés, performance des notes) pour qualifier les influenceurs. Web V3 est la surface alternative pour les mots-clés tendance, les suggestions de recherche et le fil de la page d’accueil. Les anciennes séries App V1, Web et Web V2 sont dépréciées — TikHub ne les maintient plus.

Endpoints dépréciés et supprimés

Les anciennes séries /xiaohongshu/app/ (App V1), /xiaohongshu/web/ et /xiaohongshu/web_v2/ sont dépréciées — ne construisez pas dessus. Pour le détail des notes, utilisez app_v2/get_image_note_detail ou app_v2/get_video_note_detail ; pour la recherche, app_v2/search_notes / app_v2/search_users (ou les équivalents Web V3). Les publications d’un sujet et les notes par tag passent par app_v2/get_topic_feed ; pour la découverte générale, utilisez la recherche par mot-clé.

Tarification et URL de cache de 24 heures

Les endpoints Rednote sont facturés $0.01 par requête (sans remise de volume sauf au-delà d’un million de requêtes par mois), ce qui reflète le coût de maintenance d’une cible difficile. Chaque requête renvoie des données fraîches, en temps réel, et est facturée indépendamment — TikHub ne sert jamais de données mises en cache via l’API. La cache_url présente dans chaque réponse réussie est une aide au débogage distincte : elle rouvre cette réponse exacte pendant 24 heures (accès gratuit), afin que vous puissiez la récupérer si votre code l’a mal traitée ou la partager avec un collègue. Ce n’est pas un moyen moins cher de récupérer à nouveau la même note — une requête répétée est toujours un nouvel appel en direct.

Ce qui n’est pas disponible : nombres de lectures et de téléchargements

Rednote n’expose ni le nombre de lectures (播放量) ni le nombre de téléchargements : TikHub ne peut donc pas les renvoyer — la plateforme elle-même ne publie pas ces métriques. Vous obtenez malgré tout le contenu des notes, les images, les vidéos, les profils utilisateurs, les commentaires, les likes (点赞), les partages (分享) et les résultats de recherche. Notez également qu’il n’y a pas de récupération par lot (les notes sont récupérées une par une) et que les tokens xsec ne sont plus renvoyés.

Gérer les erreurs 400 et la pagination

Le backend de Rednote peut être lent à démarrer. Si une requête renvoie une 400, réessayez quelques fois ; si elle échoue toujours, c’est que les ressources du backend se chargent — attendez 30 à 60 minutes et réessayez. Les endpoints paginés (notes d’un utilisateur, recherche) renvoient environ 6 à 20 éléments par requête, et la première page peut en renvoyer moins — continuez à paginer avec le curseur.

Rednote et Xiaohongshu (小红书), est-ce la même chose ?

Oui — Rednote est le nom international de 小红书 (Xiaohongshu), littéralement « petit livre rouge ». Les endpoints de TikHub couvrent la même plateforme, quel que soit le nom que vous recherchez.

Est-il légal d’utiliser une API Rednote de ce type ?

TikHub ne renvoie que des données Rednote publiquement accessibles — des contenus que n’importe quel visiteur peut voir sans compte. Elle ne contourne aucune authentification et n’accède à aucune information privée. Rednote est une plateforme chinoise : les contraintes pertinentes sont donc ses propres conditions d’utilisation et les règles chinoises sur les données et leur transfert transfrontalier, plutôt que la jurisprudence américaine ; l’accès automatisé peut entraîner le blocage d’un compte ou d’une IP, risque que l’infrastructure de TikHub absorbe pour vous. Vous restez responsable de la manière dont vous stockez, traitez et utilisez les données — en particulier les données personnelles et tout transfert ultérieur hors frontières.

Quelle est la limite de débit ?

La limite de débit par défaut est de 10 requêtes par seconde. Les forfaits RPS la font monter — de 20 RPS à $5/mois jusqu’à 100 RPS à $55/mois — et les comptes Enterprise bénéficient de limites personnalisées au-delà de 100 RPS.

Combien coûte l’API Rednote ?

Les endpoints Rednote sont facturés $0.01 par requête — sans remise de volume sauf au-delà d’un million de requêtes par mois, ce qui reflète le coût de maintenance d’une plateforme très protégée. Chaque requête renvoie des données fraîches, en temps réel, et est facturée indépendamment ; la cache_url présente dans chaque réponse est une aide gratuite au débogage et au partage, qui rouvre cette seule réponse pendant 24 heures — ce ne sont pas des données d’API mises en cache, un nouvel appel récupère donc toujours des données en direct. Les nouveaux comptes reçoivent $0.05 de crédit offert — sans carte bancaire.

API Rednote : lire la plateforme lifestyle chinoise en 2026

L’API Rednote de TikHub lit les données publiques de 小红书 — notes, profils, commentaires, recherche, mots-clés tendance, fil d’accueil et fiches produits — via de simples appels REST, sans inscription développeur chinoise. Voici comment elle fonctionne, pourquoi elle va plus loin qu’une extraction générique, et quelle option convient à quel travail.

Comment fonctionne l’API Rednote ?

Qu’est-ce que l’API Rednote ?

L’API Rednote de TikHub est une interface RESTful qui renvoie du JSON structuré pour les contenus publics de 小红书 (Rednote) — la plateforme qui façonne les goûts des consommateurs chinois en beauté, mode, cuisine et voyage. Vous demandez une note, un profil, un fil de commentaires, une recherche ou un classement de tendances et vous recevez des données propres et typées, sans exploiter votre propre pipeline de données face à une plateforme en chinois et fortement protégée.

Elle couvre les séries App V2, PGY et Web V3, y compris le fil d’accueil et les mots-clés tendance qui révèlent la demande au moment où elle se forme — des signaux qu’une extraction basique n’atteint pas.

Comment y accéder et l’utiliser ?

Créez un compte TikHub, générez une clé API et effectuez une requête HTTP GET avec la clé dans l’en-tête Authorization. Identifiez le contenu par ID de note, ID d’utilisateur ou terme de recherche, et vous recevez du JSON — sans compte développeur chinois ni demande auprès de la plateforme ouverte. Un enchaînement courant consiste à suivre les mots-clés tendance, à rechercher les plus chauds, puis à extraire le détail des notes et leurs commentaires pour les meilleurs résultats.

Quels sont les avantages de l’API Rednote ?

Pourquoi l’utiliser plutôt que construire un pipeline de données ?

Rednote est l’une des plateformes les plus difficiles à collecter — réponses en chinois, défenses anti-bot agressives et endpoints fréquemment renouvelés. Monter cela et le maintenir en vie représente un coût d’ingénierie réel et continu. TikHub l’absorbe et livre les séries App V2, PGY et Web V3 pour que votre intégration survive aux évolutions de la plateforme, en exposant un contrat stable sur lequel bâtir, à un prix par requête.

Qui en profite — marques, chercheurs ou équipes IA ?

Marques et agences suivent les tendances beauté et mode à leur source, surveillent leur réputation auprès des consommateurs chinois et analysent les contenus KOL/KOC avant de lancer une campagne. Les chercheurs étudient le langage d’intention d’achat et les tendances par catégorie. Les équipes IA construisent des corpus lifestyle en chinois et des pipelines de sentiment à partir d’une source structurée — la richesse en images et en commentaires des notes les rend particulièrement utiles pour le travail multimodal.

Quels sont les cas d’usage courants de l’API Rednote ?

Comment l’utiliser pour la recherche de tendances et l’e-commerce ?

Le schéma va de la tendance au produit : surveillez les mots-clés tendance, recherchez-les, puis lisez les meilleures notes et leurs commentaires pour comprendre à la fois ce qui monte et la manière dont les consommateurs en parlent. Comme les notes portent des associations de produits, vous pouvez relier l’engagement à des produits précis et suivre leur réception — faisant de Rednote une source vivante de demande et de veille concurrentielle pour les catégories de consommation chinoises.

Comment alimente-t-elle l’IA et les modèles de contenu ?

Le texte structuré des notes, les images et les fils de commentaires alimentent les modèles de sentiment, les systèmes de prédiction de tendances et les pipelines de recherche sur les contenus lifestyle chinois. Le langage d’intention d’achat présent dans les commentaires constitue un signal d’entraînement précieux pour l’IA d’e-commerce et de recommandation, et le fil d’accueil offre une fenêtre sur ce que la plateforme elle-même met en avant.

Existe-t-il des alternatives à l’API Rednote ?

Quelles autres options existent, et laquelle est la meilleure ?

La plateforme ouverte officielle de Rednote est limitée et conditionnée à une immatriculation d’entreprise chinoise ; quelques outils open source existent mais portent la charge habituelle de fiabilité et de maintenance face à une cible difficile, et la plupart des fournisseurs occidentaux ne la couvrent pas en profondeur. Pour les équipes non chinoises qui ont besoin d’une vraie profondeur — tendances, fil d’accueil, produits et commentaires — une API managée comme TikHub est le choix pratique, avec une seule clé qui couvre aussi Douyin et 14 autres plateformes.

Une seule clé, toutes les plateformes

L'API Rednote partage sa clé et son format JSON avec 15 autres plateformes — ajouter Instagram ou Douyin tient en une ligne.

Commencer gratuitement