Cross-platform · 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 |
|---|---|---|---|---|
query | string | Oui | "人工智能" | Search terms; separate terms with spaces to require all of them. Put excluded words in exclude_words. |
platforms | array | Non | ["weibo","douyin","toutiao","xiaohongshu","short_video","wechat","news","forum","long_video","app"] | Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forum Pass a JSON array in this query parameter. |
since | string | Non | — | First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until |
until | string | Non | — | Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days |
types | array | Non | ["original","repost","comment"] | Content types, all by default: original, repost, comment Pass a JSON array in this query parameter. |
sentiment | array | Non | ["negative","neutral","positive"] | Sentiment, all by default: negative, neutral, positive Pass a JSON array in this query parameter. |
match | array | Non | ["title","content","author"] | Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio Pass a JSON array in this query parameter. |
exclude_words | string | Non | — | Filter words; results that contain them are left out |
author | string | Non | — | Only content published by this author (account name) |
page | integer | Non | 1 | Page number, from 1, at most 50 |
limit | integer | Non | 20 | Results per page: 10 or 20 |
Exemple de requête
curl --get "https://api.chinaapi.ai/v1/social/cross-platform/search" \
-H "Authorization: Bearer $CHINAAPI_KEY" \
--data-urlencode 'query=人工智能'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": "cross-platform",
"capability": "search",
"data": { … }
}Pagination
Paramètres de pagination : page. 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.
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.
| Dépenses nettes cumulées | Requêtes par seconde |
|---|---|
| Débit initial payant | 10/s |
| Plus de 50 USD | 20/s |
| Plus de 500 USD | 50/s |
| Plus de 1500 USD | 100/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].