Données sociales (bêta)

/

GET /v1/social/{platform}/{capability} renvoie des données publiques de Douyin, Xiaohongshu, TikTok, YouTube et d’autres plateformes sociales, avec la même clé API et le même solde que vos appels de modèles. Chaque plateforme et chaque capacité est facturée par appel réussi, et data est la réponse propre de la plateforme — les champs ne sont pas normalisés d’une plateforme à l’autre.

GET /v1/social/{platform}/{capability} 
curl --get "https://api.chinaapi.ai/v1/social/tiktok/search" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'keyword=TikTok'

# HTTP 200
# {"object": "social.result", "platform": "tiktok", "capability": "search", "data": {...}}
Bêta : comptes payants uniquement 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.

Authentification et facturation

Envoyez votre clé ChinaAPI comme jeton bearer à https://api.chinaapi.ai, comme pour tout appel de modèle. Un appel est facturé une seule fois, au prix indiqué pour son endpoint, et seulement s’il renvoie HTTP 200 avec des données ; un résultat vide, un paramètre refusé ou un échec en amont ne coûte rien. Chaque page récupérée est un appel distinct. Votre journal d’utilisation liste chaque appel sous le nom indiqué avec son endpoint, par exemple social-douyin-search.

Réponses et erreurs

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": "douyin",
  "capability": "search",
  "data": { "...": "the platform's own fields" }
}
  • 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 — 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 — 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.

Usage acceptable

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.

Plateformes et prix

USD par appel réussi. Chaque prix renvoie à son endpoint ci-dessous, et un tiret signifie que la plateforme ne propose pas cette capacité. Le catalogue en direct — GET https://dash.chinaapi.ai/api/social/catalog, sans clé — fait foi sur ce qui est en vente à l’instant, y compris tout endpoint suspendu.

Endpoints

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.