API et serveur MCP – Trendevio

Créez un compte

Gratuit, sans carte bancaire : 100 requêtes par mois incluses.

Créez une clé

Dans Mon compte, section « Clés d'API ». Elle n'est affichée qu'une fois.

Interrogez les données

En REST avec curl, ou depuis votre assistant via le serveur MCP.

À quoi ça ressemble

À gauche, une conversation avec un assistant IA branché au serveur MCP ; à droite, la même lecture faite avec l'API REST.

Assistant IA connecté à Trendevio

Quels sont les sujets TikTok en tête en ce moment ?

get_top_trends · TikTok · limit 3 · 1 requête

Voici le top du moment sur TikTok :

Un sujet en tête du classementscore 89
Un deuxième sujetscore 88
Un troisième sujetscore 87

Souhaitez-vous le détail du score de l'un d'eux ?

Exemple de conversation

# Une requête
curl "https://trendevio.com/api/trends" \
  -G -d "platform=tiktok" -d "limit=3" \
  -H "Authorization: Bearer VOTRE_CLE"

# La réponse (extrait)
{
  "platform": "tiktok",
  "count": 3,
  "charged": 1,
  "usage": {
    "used": 1, "limit": 100
  },
  "trends": [
    {
      "title": "…",
      "region": "FR",
      "score": 89,
      "components": {
        "volume": 0.91, "velocity": 0.78,
        "freshness": 0.96, "persistence": 0.20
      }
    }
  ]
}

Exemple illustratif

Authentification

Toutes les données sont protégées : chaque appel doit porter votre clé d'API dans l'en-tête Authorization. Gardez la clé côté serveur : jamais dans un code exécuté dans le navigateur ni dans un dépôt public.

curl "https://trendevio.com/api/trends?platform=tiktok&ranking=explosion&limit=10" \
  -H "Authorization: Bearer VOTRE_CLE"

Requêtes et quota

Chaque appel consomme des requêtes de votre quota mensuel, qui se renouvelle le 1er du mois (UTC). Il n'y a pas de dépassement facturé : quand le quota est atteint, les appels répondent 429 jusqu'au renouvellement.

Appel	Coût
`GET /api/trends` et `GET /api/creators`	1 requête par tranche de 10 lignes renvoyées (10 lignes = 1, 25 lignes = 3)
`GET /api/trends/{id}` (fiche d'un sujet)	1 requête
`GET /api/usage`	Gratuit
Appel sans résultat ou en erreur	Gratuit

Offre	Requêtes par mois
Gratuit	100
Solo	1 000
Pro	5 000

Les offres payantes ne sont pas encore ouvertes : pour le moment, chaque compte dispose de l'offre gratuite. Une cadence maximale de 120 appels par minute s'applique à chaque compte.

Points d'accès

`GET /api/trends`

Classement des sujets d'une plateforme.

platform : tiktok ou youtube
ranking : moment (par défaut), explosion ou durable
region : code pays (FR, GB, US, ES, JP), facultatif
niche : par exemple food, fashion, gaming, facultatif
limit : de 1 à 100 (30 par défaut)

Pour YouTube, chaque sujet contient aussi links : l'adresse de la vidéo source et le nom de sa chaîne (liste vide pour TikTok).

{
  "ranking": "explosion",
  "platform": "tiktok",
  "tier": "free",
  "charged": 1,
  "usage": { "used": 12, "limit": 100, "remaining": 88, "resetsAt": 1796083200 },
  "count": 10,
  "trends": [
    {
      "id": 412, "title": "…", "region": "FR", "niche": "food",
      "score": 87,
      "components": { "volume": 0.9, "velocity": 0.8, "freshness": 0.95, "persistence": 0.2, "velocityKnown": true }
    }
  ]
}

`GET /api/trends/{id}`

Fiche d'un sujet : scores, éléments sources et historique de volume.

`GET /api/creators`

Créateurs en tendance. Paramètres : platform, region, limit (1 à 100). Chaque créateur indique ses abonnés, s'il est vérifié et sa vidéo phare.

`GET /api/usage`

Votre offre et votre consommation du mois. Gratuit.

{ "tier": "free", "usage": { "used": 12, "limit": 100, "remaining": 88, "resetsAt": 1796083200 } }

Serveur MCP pour assistants IA

Le serveur MCP (Model Context Protocol) permet à Claude, Cursor ou tout autre assistant compatible de lire les tendances de lui-même. Il utilise votre clé et votre quota, comme l'API REST. Adresse : https://trendevio.com/mcp.

Claude Code

claude mcp add --transport http --scope user trendevio https://trendevio.com/mcp \
  --header "Authorization: Bearer VOTRE_CLE"

Cursor, VS Code et autres

{
  "mcpServers": {
    "trendevio": {
      "url": "https://trendevio.com/mcp",
      "headers": { "Authorization": "Bearer VOTRE_CLE" }
    }
  }
}

Outil	Ce qu'il fait	Coût
`get_top_trends`	Classement d'une plateforme, avec score et composantes	1 requête / 10 sujets
`get_creators`	Créateurs en tendance	1 requête / 10 créateurs
`get_usage`	Votre quota restant et sa date de renouvellement	Gratuit

Erreurs

Statut	Code	Signification
401	`missing_api_key`	Aucune clé fournie
401	`invalid_api_key`	Clé inconnue, mal formée ou révoquée
429	`monthly_limit_reached`	Quota mensuel de requêtes atteint ; la réponse contient `usage` avec la date de renouvellement
429	`rate_limited`	Plus de 120 appels en une minute : réessayez après quelques secondes
400	—	Paramètre invalide (classement inconnu, identifiant incorrect…)

Règles d'usage

La clé est personnelle : ne la partagez pas, ne la revendez pas et ne la donnez pas à vos propres clients.
Vous pouvez utiliser les données pour vos analyses, rapports, outils internes et contenus, en citant « Données Trendevio » si possible.
Il est interdit de republier ou revendre les données en bloc comme flux ou API concurrente, et de s'en servir pour entraîner un modèle sans accord écrit.
Les scores sont calculés par Trendevio à partir de signaux publics de TikTok et YouTube : ils ne sont ni affiliés ni approuvés par ces plateformes.
Vous pouvez révoquer une clé à tout moment depuis votre compte ; elle cesse alors de fonctionner immédiatement.