← API de données

Bilibili · Créateurs similaires

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.

Comptes sans paiement : 50 appels par jour maximum. Comptes payants : aucune limite quotidienne. Réinitialisation à 00:00 UTC. · 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.

NomTypeRequisExempleDescription
upper_midintegerOui546195Bilibili creator UID

Exemple de requête

curl --get "https://api.chinaapi.ai/v1/social/bilibili/creator-similar" \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  --data-urlencode 'upper_mid=546195'

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": "bilibili",
  "capability": "creator-similar",
  "data": { … }
}

Pagination

Cet endpoint n’a pas de paramètre de pagination.

Erreurs et cas non facturés

Code d'étatCode d’erreurSignification
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—Cette clé API ne dispose pas des autorisations nécessaires pour cette requête.
404social_data_no_resultLe couple plateforme-capacité n’existe pas, ou la plateforme n’a rien trouvé pour ces paramètres (social_data_no_result).
429data_api_daily_limit_exceededsocial_data_capacity_reachedLa 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. Comptes sans paiement : 50 appels par jour maximum. Comptes payants : aucune limite quotidienne. Réinitialisation à 00:00 UTC.
502social_data_no_resultLa source de données n’a pas répondu, ou a répondu sans données.
503social_data_unavailableCet 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

Comptes sans paiement : 50 appels par jour maximum. Comptes payants : aucune limite quotidienne. Réinitialisation à 00:00 UTC. 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.

Avantages de débit de l’API de données

Avantages de débit de l’API de données

Les comptes payants démarrent à 10 requêtes/seconde et progressent automatiquement selon les dépenses nettes cumulées, jusqu’à 100 requêtes/seconde.

Comptes sans paiement : 50 appels par jour maximum. Comptes payants : aucune limite quotidienne. Réinitialisation à 00:00 UTC.

Dépenses nettes cumuléesRequêtes par seconde
Débit initial payant10/s
Plus de 50 USD20/s
Plus de 500 USD50/s
Plus de 1500 USD100/s

Base des dépenses : frais réglés de l’API de données, moins les remboursements des appels. Les rechargements et dépenses des API de modèles sont exclus.

Toutes les clés API d’un compte partagent ce débit. Il s’agit de requêtes par seconde, pas de requêtes simultanées.

Les interfaces des fournisseurs ont leurs propres limites de capacité, qui influent aussi sur le débit disponible.

Besoin d’un débit plus élevé ? Écrivez-nous à [email protected].