Articles sur : API et Intégrations
Cet article est aussi disponible en :

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 (X-Mc-Auth)

Content-Type requis ?

Conseils utiles

n8n

Dans les identifiants : Header Auth

✅ application/json

Utilisez “Generic Credential Type” + “Header Auth”. Réutilisable sur plusieurs nœuds.

Make

Dans le module HTTP : section Headers

✅ application/json

Module HTTP personnalisé ou module officiel Metricool.

Zapier

Dans “Webhooks by Zapier” : Headers

✅ application/json

À configurer dans les options avancées.

Postman

Dans l’onglet Headers de la requête

✅ application/json

Parfait pour tester vos appels manuellement.


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


  1. 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 ne sont pas listés explicitement dans la documentation PDF, mais vous pouvez facilement les identifier vous-même en suivant ces étapes.


Étapes pour trouver un endpoint
  1. Accédez à la section de Metricool où s’affichent les données que vous souhaitez récupérer via l’API (par exemple : analytics YouTube, publications Instagram, etc.).
  2. Ouvrez les outils de développement de votre navigateur :
  • Dans la plupart des navigateurs : clic droit → “Inspecter” → onglet Réseau ou Network.
  • Rechargez la page si nécessaire.
  1. Filtrez par type fetch/XHR pour voir les appels effectués au backend de Metricool.
  2. Recherchez l’endpoint contenant les données affichées à l’écran.

Par exemple, dans la section analytique de YouTube, vous verrez quelque chose comme youtube/videosStats.

  1. Copiez cette URL et adaptez-la à vos requêtes API.


Ce processus est expliqué en détail à partir de la page 8 de la documentation PDF. Téléchargez-la ici : 👉 Documentation API Metricool (PDF)


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.



💡 Astuce : Utilisez les endpoints dynamiques pour créer vos requêtes API. Consultez la documentation technique et le guide d’utilisation ici.


⚠️ 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>


  1. Utilisez ensuite le mediaId retourné :


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


Mis à jour le : 06/08/2025

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !