Xiaohongshu (RED) · Recherche de publications

Bêta

Les données publiques des réseaux sociaux, facturées à l’appel, avec la même clé API et le même solde que vos appels de modèles.

Réservé aux comptes payants : une première recharge est requise, sans essai gratuit · Un appel n’est facturé que s’il renvoie HTTP 200 avec un data non vide ; les résultats vides, les paramètres refusés et les échecs en amont ne sont pas facturés.

Paramètres de requête

Les paramètres vont dans la query string, sous les noms propres à la plateforme. Les exemples viennent du catalogue ; remplacez les identifiants par ceux du contenu à récupérer.

Nom	Type	Requis	Exemple	Description
`keyword`	string	Oui	`"美食推荐"`	Search keyword
`page`	integer	Non	`1`	Page number, start from 1
`sort_type`	string	Non	`"general"`	Sort type
`note_type`	string	Non	`"不限"`	Note type: 不限 (all), 视频笔记 (video), 普通笔记 (standard), 直播笔记 (live). Send the literal Chinese value.
`time_filter`	string	Non	`"不限"`	Time filter: 不限 (all), 一天内 (one day), 一周内 (one week), 半年内 (half year). Send the literal Chinese value.
`search_id`	string	Non	`""`	Search ID for pagination
`search_session_id`	string	Non	`""`	Search session ID for pagination
`source`	string	Non	`"explore_feed"`	Source
`ai_mode`	integer	Non	`0`	AI mode: 0=off, 1=on

Exemple de requête

curl --get "https://api.chinaapi.ai/v1/social/xiaohongshu/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=美食推荐'

Forme de la réponse

Une réponse réussie enveloppe les données de la plateforme dans une petite structure. Tout ce qui se trouve dans data — noms de champs, curseurs de pagination, identifiants — appartient à la plateforme ; renvoyez les curseurs exactement tels que vous les avez reçus.

{
  "object": "social.result",
  "platform": "xiaohongshu",
  "capability": "search",
  "data": { … }
}

Pagination

Paramètres de pagination : page, search_id, search_session_id. Chaque page est un appel facturé séparément ; reprenez les valeurs de curseur de la réponse précédente telles quelles.

Erreurs et cas non facturés

Code d'état	Code d’erreur	Signification
400	—	Un paramètre est inconnu, répété, trop long, du mauvais type ou manquant, y compris quand aucun membre d’un groupe « au moins un de » n’est fourni. Le `code` de l’erreur précise lequel, par exemple `unknown_parameter` ou `missing_parameter`.
403	`model_requires_topup`	Le compte n’a pas effectué sa première recharge.
404	`social_data_no_result`	Le couple plateforme-capacité n’existe pas, ou la plateforme n’a rien trouvé pour ces paramètres (`social_data_no_result`).
429	`social_data_capacity_reached`	La capacité quotidienne de la bêta est épuisée et se réinitialise à 00:00 UTC, ou la plateforme est occupée et une nouvelle tentative quelques secondes plus tard suffira. Ne relancez pas en boucle serrée.
502	`social_data_no_result`	La source de données n’a pas répondu, ou a répondu sans données.
503	`social_data_unavailable`	Cet endpoint est suspendu en ce moment ; le catalogue en direct l’indique comme `paused`.

Aucune de ces réponses n’est facturée.

Chaque réponse porte un en-tête X-Oneapi-Request-Id ; joignez-le lorsque vous contactez le support et nous retrouverons cet appel précis.

Conditions de la bêta

Effectuez votre première recharge avant d’appeler. Le crédit d’essai ne peut pas être dépensé sur ces endpoints ; un compte qui n’a jamais rechargé reçoit HTTP 403 model_requires_topup. La bêta n’a pas de SLA, et ses plateformes, endpoints et prix peuvent changer.

Respectez les conditions de chaque plateforme et les règles de protection des données qui s’appliquent à vous. N’utilisez pas cette API pour établir des profils de personnes. La connexion à des comptes, l’extraction de coordonnées, la manipulation de l’engagement et l’accès à des contenus privés ou payants sont hors du périmètre de cette bêta.