Integrazioni tramite l'API di Metricool

Domande e errori comuni quando si usa l'API

Usa questa guida per le domande comuni sulla configurazione dell'API di Metricool e per gli errori quando lavori con strumenti come n8n, Make, Zapier o Postman.

Domande comuni

Queste risposte coprono autenticazione, ID, date, endpoint, media e strumenti che non sono elencati nella tabella.

Dove devo inserire il token di autenticazione?

Includi il token del tuo account Metricool nell'intestazione della richiesta come segue:

X-Mc-Auth: YOUR API TOKEN

Includi anche:

Content-Type: application/json

La tua richiesta deve includere entrambi i parametri blogId e userId.

Tabella riepilogativa degli strumenti

Strumento

Dove inserire il token (X-Mc-Auth)

Richiede Content-Type?

Suggerimenti utili

n8n

Nelle credenziali: Header Auth

✅ application/json

Usa “Generic Credential Type” + “Header Auth”. Puoi riutilizzarlo in più nodi.

Make

Nel modulo HTTP: sezione Headers

✅ application/json

Usa un modulo HTTP personalizzato o quello ufficiale di Metricool.

Zapier

In “Webhooks by Zapier”: sezione Headers

✅ application/json

Aggiungi l'intestazione nella configurazione avanzata di Webhook.

Postman

Nella scheda Headers della richiesta

✅ application/json

Perfetto per i test manuali.

Come faccio a ottenere il mio blogId?

Hai due opzioni:

  1. Dall'URL di Metricool
    Quando accedi a un brand nel tuo account, vedrai un URL come questo. Copia il numero dopo blogId; identifica ogni brand. Il numero dopo userId identifica il tuo account. Per una procedura guidata dedicata all'ID dell'account, vedi Come trovare il tuo ID utente di Metricool.

https://app.metricool.com/evolution/web?blogId=00000&userId=0000000

  1. Tramite API
    Chiama questo endpoint. Restituisce un elenco di tutti i brand che gestisci o che sono stati condivisi con te. Ogni voce include il corrispondente blogId:

https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID
Che formato deve usare publicationDate?

Usa ISO 8601, includendo il fuso orario. Esempio:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Madrid"
}
Come posso trovare l'endpoint API di cui ho bisogno su Metricool?

Alcuni endpoint dell'API di Metricool non sono elencati nella documentazione PDF. Puoi trovarli ispezionando il browser.

Segui la guida completa in Come ottenere un endpoint passo dopo passo. Quell'articolo include un video tutorial.

Posso caricare immagini o video tramite l'API?

Sì. Prima carica il media su Metricool e ottieni un mediaId, poi usalo nel tuo post. I link ai media devono essere pubblici e non devono scadere. Chiama l'endpoint normalize così il file viene ospitato sui server di Metricool.

Posso usare l'API con strumenti non elencati sopra?

Sì. Qualsiasi strumento che permetta richieste HTTP con intestazioni personalizzate può essere integrato con l'API di Metricool.

Errori comuni e come risolverli

Usa queste soluzioni quando una richiesta viene rifiutata o un post viene programmato senza media.

Accesso negato (o simile)

Questo errore significa che il token non viene inviato correttamente oppure non ha accesso al brand (blog) su cui stai cercando di pubblicare.

✅ Correzione

  • Ricontrolla di stare usando il token corretto del tuo account Metricool.

  • Assicurati che sia inserito esattamente come mostrato nella tabella sopra.

  • Conferma che blogId e userId appartengano al tuo account.

Esempio n8n:

Il post è programmato ma non ha immagini o video

Questo significa che il media non è stato gestito correttamente prima della richiesta API.

✅ Correzione

  1. Assicurati che il link del media sia pubblico e non scada. Gli URL privati o temporanei vengono saltati.

  2. Includi mediaId nel tuo post. Senza di esso, il post viene programmato senza media.

  3. Prima di chiamare https://app.metricool.com/api/v2/scheduler/posts, normalizza l'URL del media con una richiesta GET a:

https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>

Questo ospita il file sui server di Metricool quando necessario e restituisce un URL valido che puoi trasformare in un mediaId.

  1. Usa il mediaId restituito nel tuo post:

"media": {
"mediaId": "ID_OF_MEDIA"
}

È stato utile?