Questions fréquentes et erreurs courantes lors de l’utilisation de l’API
Résolvez vos questions sur l’utilisation de l’API avec des outils externes
Vous utilisez des outils comme n8n, Make, Zapier ou Postman pour planifier des publications ou automatiser des tâches avec l’API de Metricool ? Voici les réponses aux questions les plus fréquentes et les erreurs courantes.
❓ Questions fréquentes
Où dois-je insérer le token d’authentification ?
Dans tous les cas, le token de votre compte Metricool doit être envoyé dans l’en-tête :
X-Mc-Auth: VOTRE TOKEN API
Il est également obligatoire d’inclure :
Content-Type: application/json
⚠️ Vérifiez que votre requête inclut toujours les paramètres blogId
et userId
.
📋 Tableau récapitulatif par outil
Outil | Où insérer le token ( | | Conseils utiles |
---|---|---|---|
n8n | Dans les identifiants : Header Auth | ✅ | Utilisez “Generic Credential Type” + “Header Auth”. Réutilisable sur plusieurs nœuds. |
Make | Dans le module HTTP : section Headers | ✅ | Module HTTP personnalisé ou module officiel Metricool. |
Zapier | Dans “Webhooks by Zapier” : Headers | ✅ | À configurer dans les options avancées. |
Postman | Dans l’onglet Headers de la requête | ✅ | Parfait pour tester vos appels manuellement. |
Comment obtenir mon blogId
?
Deux options s’offrent à vous :
- Depuis l’URL Metricool
Lorsque vous accédez à une marque dans votre compte, vous verrez une URL similaire. Vous devez copier le numéro qui suit blogId
, qui identifie chaque marque. (Le numéro qui suit userId
correspond à votre compte.)
https://app.metricool.com/evolution/web?blogId=00000&userId=0000000
- Via l’API :
Faites un appel à cet endpoint. Il renvoie la liste des marques que vous gérez ou qui vous ont été partagées. Chaque entrée contient son blogId
:
https://app.metricool.com/api/admin/simpleProfiles?userId=VOTRE_USER_ID
Quel format doit avoir la date de publication (publicationDate
) ?
Utilisez le format ISO 8601, incluant le fuseau horaire. Exemple :
"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Paris"
}
Puis-je ajouter des images ou vidéos via l’API ?
Oui. Vous devez d’abord charger le fichier sur Metricool, récupérer son mediaId
, puis l’inclure dans votre publication. Assurez-vous que les liens sont publics et ne soient pas temporaires. Il est recommandé de normaliser l’URL au préalable via l’endpoint normalize
pour garantir qu’elle soit hébergée sur les serveurs de Metricool.
Puis-je utiliser l’API avec d’autres outils ?
Oui. Tout outil permettant d’effectuer des requêtes HTTP avec des en-têtes personnalisés peut être intégré avec l’API de Metricool.
⚠️ Erreurs courantes (et solutions)
Accès refusé (ou erreur similaire)
Cela signifie que le token n’a pas été transmis correctement ou n’a pas accès à la marque ciblée.
✅ Solution :
- Vérifiez que vous utilisez le bon token depuis votre compte Metricool.
- Assurez-vous qu’il est bien placé dans l’en-tête.
- Vérifiez que le
blogId
et leuserId
correspondent bien à votre compte.
🔎 Exemple n8n :
Le post est programmé mais n’inclut ni image ni vidéo
Ce cas survient lorsque le contenu multimédia n’a pas été correctement préparé avant l’envoi.
✅ Solution :
- Assurez-vous que l’URL est publique et permanente.
- Vérifiez que vous incluez bien le
mediaId
dans la publication. - Avant l’appel à
https://app.metricool.com/api/v2/scheduler/posts
, normalisez l’URL via :
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_DE_VOTRE_FICHIER>
- Utilisez ensuite le
mediaId
retourné :
"media": {
"mediaId": "ID_DU_MEDIA"
}
Mis à jour le : 30/07/2025
Merci !