Ajouter du contenu à une autoliste à l’aide de l’API

Mis à jour le mois dernier

Vous pouvez ajouter du contenu à une autoliste existante via l’API en deux appels : créez un emplacement vide dans la liste, puis remplissez cet emplacement avec le texte et les médias de votre publication. Cela fonctionne depuis n’importe quel client HTTP, notamment Postman, Make, n8n ou Zapier.

Prérequis

Les deux appels nécessitent votre userToken, userId, blogId et l’identifiant interne de l’autoliste.

Valeur	Où le trouver
`userToken`	Paramètres du compte > section API > jeton d’accès à l’API REST. Envoyez-le dans l’en-tête de requête `X-Mc-Auth`.
`userId`	Identifiant de votre utilisateur Metricool. Consultez Comment trouver votre identifiant utilisateur Metricool.
`blogId`	Identifiant de la marque/profil, visible dans l’URL du navigateur lorsque vous utilisez cette marque dans Metricool.
`listid`	Identifiant interne de l’autoliste. Il ne correspond pas toujours à l’identifiant affiché dans l’URL du planificateur (`/planner/autolist/{X}`) : vérifiez-le dans la réponse de l’appel de l’étape 1 au lieu de le supposer.

Ajouter du contenu à l’autoliste

Créer un emplacement vide

La création d’un emplacement réserve une position dans l’autoliste. La réponse contient le tableau complet de l’autoliste, y compris l’id du nouvel élément : utilisez cette valeur comme postid à l’étape suivante.

GET https://app.metricool.com/api/lists/posts/create?listid={listId}&position={position}&userId={userId}&blogId={blogId}

Champ	Description
`listid`	Identifiant interne de l’autoliste.
`position`	Emplacement où insérer la nouvelle publication. `0` l’insère en haut de la liste.

Chaque appel à ce point de terminaison ajoute une nouvelle ligne vide à l’autoliste, même si vous n’effectuez pas l’étape suivante. Des appels répétés accumulent des lignes vides : supprimez-les de l’autoliste avec l’option Tout supprimer dans le planificateur Metricool.

Remplir l’emplacement avec du contenu

Envoyez cet appel au format form-data, et non au format JSON.

POST https://app.metricool.com/api/lists/posts/updatepostlist?userId={userId}&blogId={blogId}

Champ	Valeur
`listid`	Identifiant interne de l’autoliste.
`text`	Contenu textuel de la publication.
`postid`	L’`id` renvoyé à l’étape précédente.
`pictures`	Fichier image ou vidéo de la publication. S’il n’y a pas d’image, envoyez `[]` : une valeur vide ou vierge enregistre le texte, mais entraîne l’échec silencieux du reste de la requête.

Dépannage

500 InternalError: "Request method 'POST' is not supported"

Vous avez appelé /api/lists/posts/create avec POST. Ce point de terminaison accepte uniquement GET : passez la méthode de requête à GET et conservez les mêmes paramètres de requête.

La requête aboutit, mais la publication ne s’affiche pas correctement

Si pictures a été envoyé comme valeur vierge ou vide au lieu de [], l’appel renvoie un succès et enregistre le text, mais le reste de la mise à jour échoue silencieusement. Renvoyez la requête avec pictures défini sur [] lorsqu’il n’y a pas d’image.

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