Guide de base pour l’intégration d’une API

Mis à jour aujourd’hui

L’API Metricool connecte vos propres outils et scripts à Metricool afin que vous puissiez exporter des données et créer, programmer et gérer des publications depuis l’extérieur de l’application. Ce guide vous accompagne de l’obtention de l’accès jusqu’à votre premier appel d’API.

Avant de commencer

L’API est disponible avec les forfaits Advanced et Custom. Les forfaits Free et Starter n’incluent pas l’accès à l’API.

Accédez à Paramètres du compte > API.
Copiez votre jeton d’accès à l’API.
Ouvrez la documentation officielle de l’API en cliquant sur l’icône d’information ℹ️ située à côté du champ du jeton, ou directement à l’adresse https://app.metricool.com/resources/apidocs/index.html. Un guide PDF téléchargeable est également disponible : API English PDF.

Authentifier chaque appel

Tous les endpoints nécessitent une authentification avec trois valeurs : votre jeton dans l’en-tête X-Mc-Auth, ainsi que userId et blogId comme paramètres de la requête. Les requêtes contenant un corps utilisent également Content-Type: application/json.

X-Mc-Auth: YOUR_API_TOKEN
Content-Type: application/json

userId identifie votre compte Metricool et blogId identifie la marque. Vous pouvez lire ces deux valeurs dans l’URL du navigateur lorsque vous ouvrez une marque dans l’application :

https://app.metricool.com/evolution/web?blogId=00000&userId=0000000

Pour répertorier toutes les marques que vous gérez ou qui sont partagées avec vous, appelez https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID. Chaque entrée inclut son blogId. Pour consulter un guide détaillé sur l’identifiant du compte, consultez Comment trouver votre identifiant utilisateur Metricool.

Créer et programmer une publication

Envoyez une requête POST à l’endpoint du planificateur avec la date de publication, le texte de la publication et au moins un réseau :

POST https://app.metricool.com/api/v2/scheduler/posts?blogId={blogId}&userId={userId}

Le corps de la requête doit contenir :

publicationDate : la date doit être ultérieure à la date actuelle et au format ISO 8601 avec un fuseau horaire, par exemple Europe/Madrid.
text : le contenu de la publication.
providers : au moins un réseau, par exemple { "network": "facebook" }.

Exemple de corps de requête :

{
  "publicationDate": {
    "dateTime": "2025-07-23T10:00:00",
    "timezone": "Europe/Madrid"
  },
  "text": "Hello! This is a scheduled post test.",
  "providers": [
    { "network": "facebook" }
  ]
}

Les paramètres facultatifs incluent draft (définissez-le sur true pour enregistrer la publication comme brouillon au lieu de la programmer), autoPublish, firstCommentText et des blocs spécifiques à chaque réseau tels que facebookData, instagramData, twitterData, linkedinData, pinterestData, youtubeData, tiktokData, gmbData, threadsData et blueskyData pour les options propres à chaque réseau, comme le type de publication Facebook ou la publication automatique sur Instagram. La référence complète des paramètres figure dans les fichiers Swagger .yaml et .json liés depuis la documentation de l’API.

Ce que vous pouvez faire avec les publications programmées

Les endpoints du planificateur prennent en charge les actions suivantes. Tous les chemins sont relatifs à l’URL de base https://app.metricool.com/api.

Action	Méthode et chemin
Créer une publication programmée	`POST /v2/scheduler/posts`
Répertorier les publications programmées entre deux dates	`GET /v2/scheduler/posts`
Obtenir une publication programmée par son ID	`GET /v2/scheduler/posts/{id}`
Mettre à jour une publication programmée	`PUT /v2/scheduler/posts/{id}`
Modifier et mettre à jour certains champs	`PATCH /v2/scheduler/posts/{id}`
Supprimer une publication programmée	`DELETE /v2/scheduler/posts/{id}`
Envoyer en masse plusieurs publications d’une marque pour révision	`PUT /v2/scheduler/posts`
Approuver ou rejeter une publication programmée	`PUT /v2/scheduler/posts/{id}/approvals`
Obtenir la configuration de la marque pour envoyer une publication en révision	`GET /v2/scheduler/posts/approvals-config`
Obtenir les propriétés des publications Instagram d’une marque	`GET /v2/scheduler/posts/instagram-properties`

Ajouter des médias à une publication programmée

Les liens vers les médias doivent être publics et ne doivent pas expirer : les URL privées ou temporaires sont ignorées et la publication est programmée sans média. Pour joindre un média, préparez-le avant d’appeler l’endpoint du planificateur :

Normalisez l’URL du média avec une requête GET afin que le fichier soit hébergé sur les serveurs Metricool lorsque cela est nécessaire :
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>
Référencez le média dans votre publication via son mediaId :
"media": { "mediaId": "ID_OF_MEDIA" }

Sans l’identifiant du média dans la requête, la publication est programmée sans média. Consultez l’exemple complet dans Questions fréquentes et erreurs courantes lors de l’utilisation de l’API.

Limites de publication

Chaque réseau social limite ce que les outils tiers peuvent publier via sa propre API. Toutes les fonctionnalités du planificateur ne sont donc pas disponibles via l’API Metricool. Pour consulter la liste, par réseau, des actions de publication, Inbox et Rapports non prises en charge, consultez Limitations de l’API par réseau social.

Les champs propres à chaque réseau dans le corps de la requête varient également selon le réseau. Consultez les fichiers Swagger .yaml et .json dans la documentation de l’API pour connaître les champs disponibles pour chaque réseau avant de créer la requête.

Mise en œuvre de l’API

Pour exporter des données depuis Metricool à l’aide de notre API vers d’autres plateformes, telles qu’Excel, Google Sheets, MySQL et d’autres, suivez les étapes générales suivantes :

Obtenez le jeton d’accès dans Paramètres du compte > API, comme indiqué ci-dessus.
Configurez le client HTTP : utilisez un outil d’intégration comme Postman ou un langage de programmation (par exemple, Python avec requests) et configurez l’en-tête X-Mc-Auth avec votre jeton.
Envoyez une requête GET à l’endpoint correspondant aux données souhaitées (publications, statistiques, rapports). Tous les appels nécessitent userId et blogId. Utilisez l’inspecteur du navigateur pour afficher les appels effectués par Metricool et leurs paramètres, comme indiqué dans Comment obtenir un endpoint dans Metricool pour effectuer des appels d’API.
Mettez les données en forme : les réponses sont généralement au format JSON. Associez donc les champs à la structure attendue par votre plateforme cible.
Exportez les données vers la plateforme cible.

Chaque plateforme cible possède sa propre méthode d’intégration, mais le flux général suit ce schéma.

Documentation

Voici les liens vers la documentation des API des plateformes les plus couramment utilisées pour la gestion des données :

Surveiller l’utilisation et renouveler votre jeton

Paramètres du compte > API affiche votre utilisation actuelle de l’API ainsi que l’historique des endpoints utilisés. Vous pouvez également récupérer les statistiques d’utilisation via l’API avec GET /v2/settings/users/{userId}/api-usage-stats, qui accepte les paramètres from, to et aggregation et renvoie les appels effectués pour chaque endpoint.

Si vous devez remplacer votre jeton, vous pouvez en générer un nouveau depuis Paramètres du compte > API. La régénération invalide immédiatement l’ancien jeton et toutes les intégrations qui l’utilisent cessent de fonctionner jusqu’à sa mise à jour. Consultez Régénérer votre jeton de connexion à l’API.

Articles connexes

Cela vous a-t-il été utile ?