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


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 : 30/07/2025

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

Partagez vos commentaires

Annuler

Merci !