API Tutorial

Comment récupérer les statistiques Snapchat par API

Pour obtenir les statistiques Snapchat par API, connecte Snapchat via Modiva puis appelle `analytics_unified` — il renvoie la portée, les impressions, l'engagement et les métriques d'abonnés sous une forme normalisée que tu peux visualiser ou analyser.

Chaque plateforme rapporte ses métriques différemment, si bien qu'un reporting multiplateforme suppose généralement une couche de mapping par réseau. L'outil `analytics_unified` de Modiva renvoie les métriques Snapchat dans le même schéma que toute autre plateforme, si bien qu'une seule requête alimente un tableau de bord entier.

Étape par étape

Créer un compte Modiva et une clé MCP

Inscris-toi gratuitement et génère une clé MCP (`mk_live_…`) dans le tableau de bord. La même clé authentifie à la fois le serveur MCP hébergé (pour les agents IA) et l'API REST (pour ton backend), si bien que tu ne gères qu'un seul identifiant d'accès.

Connecter ton compte Snapchat

Dans le tableau de bord, clique sur Connecter et choisis Snapchat. Modiva exécute le flux OAuth et demande les scopes appropriés à ta place, puis stocke les tokens d'accès et de rafraîchissement dans un coffre chiffré et les maintient à jour — tu ne manipules jamais les identifiants d'API bruts de Snapchat. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.

Appeler analytics_unified pour les métriques Snapchat

Appelle `analytics_unified` avec l'ID de connexion, les métriques souhaitées et une plage de dates. Modiva les récupère depuis Snapchat, normalise les noms de champs et renvoie une forme JSON cohérente, prête à visualiser.

Regrouper chaque plateforme dans un seul rapport

Transmets plusieurs ID de connexion pour combiner Snapchat avec le reste de ta stack dans une seule réponse. Via MCP, un agent peut récupérer les chiffres et rédiger le rapport hebdomadaire à ta place, puis appeler `analytics_best_time_to_post` pour planifier le suivant.

Exemple de requête

Appelez l'outil analytics_unified via l'API REST de Modiva. Le même outil est disponible pour les agents IA sur le serveur MCP à l'adresse https://mcp.modiva.ai/v1.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "analytics_unified",
    "connectionId": "conn_…",
    "args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
  }'

Essayez-le avec Snapchat

Commencer gratuitement

FAQ

Les métriques Snapchat sont-elles comparables à celles des autres plateformes ?

Oui — Modiva normalise les statistiques Snapchat dans un schéma commun, si bien que la portée et l'engagement concordent sur chaque réseau connecté.

Un agent IA peut-il produire le rapport ?

Oui. Expose `analytics_unified` via MCP, et un agent peut récupérer les chiffres Snapchat et rédiger la synthèse de lui-même.

Continuez à construire avec Snapchat

Intégration de l'API Snapchat Serveur MCP Snapchat Comment publier sur Snapchat par API Comment planifier des publications Snapchat par API Comment envoyer des messages Snapchat par API Comment récupérer les statistiques Instagram par API Comment récupérer les statistiques TikTok par API