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

Comment obtenir mon blogId ?

Deux options s’offrent à vous :

1. 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

2. 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"
}

Comment trouver l’endpoint de l’API Metricool dont j’ai besoin ?

Certains endpoints de l’API de Metricool ne sont pas explicitement listés dans la documentation PDF, mais vous pouvez facilement les obtenir vous-même en inspectant le navigateur.

📝 Le vidéo est disponible en espagnol et en anglais. Si vous consultez l’article dans une autre langue, vous devrez passer à l’une de ces versions pour le visualiser.

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 le userId 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 :

1. Assurez-vous que l’URL est publique et permanente.
2. Vérifiez que vous incluez bien le mediaId dans la publication.
3. 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>

4. Utilisez ensuite le mediaId retourné :

"media": {
"mediaId": "ID_DU_MEDIA"
}

Mis à jour le : 24/03/2026