Guide de base pour l’intégration d’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 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 depuis l’icône d’information ℹ️ à 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 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 une procédure détaillée concernant l’ID du compte, reportez-vous à How to find your Metricool user ID.

Créer et programmer une publication

Envoyez une requête POST à l’endpoint du programmateur 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 inclure :

publicationDate : la date doit être ultérieure à la date actuelle, 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 des 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 se trouve 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 programmateur 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 plusieurs publications d’une marque pour révision en bloc	`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 des 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 programmateur :

Normalisez l’URL du média avec une requête GET afin que le fichier soit hébergé sur les serveurs de 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 Common questions and errors when using the API.

Limitations de publication

Chaque réseau social limite ce que les outils tiers peuvent publier via sa propre API. Toutes les fonctionnalités du programmateur ne sont donc pas disponibles via l’API Metricool. Pour consulter la liste des actions de publication, de boîte de réception et de Rapports non prises en charge pour chaque réseau, reportez-vous à API Limitations per Social Network.

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 de 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 ces étapes générales :

Obtenez le jeton d’accès depuis Paramètres du compte > API, comme décrit 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, métriques, rapports). Tous les appels nécessitent userId et blogId. Utilisez l’inspecteur du navigateur pour voir les appels effectués par Metricool et leurs paramètres, comme indiqué dans How to get an endpoint in Metricool to make API calls.
Formatez les données : les réponses sont généralement au format JSON. Mappez donc les champs sur 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 génération d’un nouveau jeton invalide immédiatement l’ancien, et toutes les intégrations qui l’utilisent cessent de fonctionner jusqu’à leur mise à jour. Consultez Regenerate your API connection token.

Ressources supplémentaires

📹 Tutoriel sur l’API Metricool : comment commencer — EN · ES

Articles connexes

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