Guida di base all'integrazione API

Aggiornato settimana scorsa

L'API di Metricool collega i tuoi strumenti e script a Metricool, così puoi esportare dati e creare, programmare e gestire post dall'esterno dell'app. Questa guida ti accompagna dall'ottenimento dell'accesso fino alla prima chiamata API.

Prima di iniziare

L'API è disponibile nei piani Advanced e Custom. I piani Free e Starter non includono l'accesso API.

Vai a Impostazioni account > API.
Copia il token di accesso API.
Apri la documentazione ufficiale dell'API dall'icona informativa ℹ️ accanto al campo del token oppure direttamente all'indirizzo https://app.metricool.com/resources/apidocs/index.html. È disponibile anche una guida PDF scaricabile: API English PDF.

Autentica ogni chiamata

Tutti gli endpoint richiedono l'autenticazione con tre valori: il token nell'header X-Mc-Auth, più userId e blogId come parametri della richiesta. Le richieste con un corpo utilizzano anche Content-Type: application/json.

X-Mc-Auth: YOUR_API_TOKEN
Content-Type: application/json

userId identifica il tuo account Metricool e blogId identifica il brand. Puoi leggere entrambi dall'URL del browser quando apri un brand nell'app:

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

Per elencare ogni brand che gestisci o che è condiviso con te, chiama https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID. Ogni elemento include il relativo blogId. Per una guida dettagliata sull'ID dell'account, consulta Come trovare il tuo ID utente Metricool.

Crea e programma un post

Invia una richiesta POST all'endpoint di programmazione con la data di pubblicazione, il testo del post e almeno un social network:

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

Il corpo della richiesta deve includere:

publicationDate: la data deve essere futura e in formato ISO 8601 con fuso orario, ad esempio Europe/Madrid.
text: il contenuto del post.
providers: almeno un social network, ad esempio { "network": "facebook" }.

Esempio di corpo della richiesta:

{
  "publicationDate": {
    "dateTime": "2025-07-23T10:00:00",
    "timezone": "Europe/Madrid"
  },
  "text": "Hello! This is a scheduled post test.",
  "providers": [
    { "network": "facebook" }
  ]
}

Le impostazioni facoltative includono draft (impostalo su true per salvare il post come bozza anziché programmarlo), autoPublish, firstCommentText e blocchi specifici per i vari social network come facebookData, instagramData, twitterData, linkedinData, pinterestData, youtubeData, tiktokData, gmbData, threadsData e blueskyData per opzioni specifiche, come il tipo di post su Facebook o la pubblicazione automatica su Instagram. Il riferimento completo dei parametri si trova nei file Swagger .yaml e .json collegati dalla documentazione API.

Cosa puoi fare con i post programmati

Gli endpoint di programmazione supportano queste azioni. Tutti i percorsi sono relativi all'URL di base https://app.metricool.com/api.

Azione	Metodo e percorso
Crea un post programmato	`POST /v2/scheduler/posts`
Elenca i post programmati tra due date	`GET /v2/scheduler/posts`
Recupera un post programmato tramite ID	`GET /v2/scheduler/posts/{id}`
Aggiorna un post programmato	`PUT /v2/scheduler/posts/{id}`
Modifica e aggiorna i campi selezionati	`PATCH /v2/scheduler/posts/{id}`
Elimina un post programmato	`DELETE /v2/scheduler/posts/{id}`
Invia più post di un brand alla revisione in blocco	`PUT /v2/scheduler/posts`
Approva o rifiuta un post programmato	`PUT /v2/scheduler/posts/{id}/approvals`
Recupera la configurazione del brand per inviare un post alla revisione	`GET /v2/scheduler/posts/approvals-config`
Recupera le proprietà dei post Instagram di un brand	`GET /v2/scheduler/posts/instagram-properties`

Aggiungi contenuti multimediali a un post programmato

I link ai contenuti multimediali devono essere pubblici e non devono scadere: gli URL privati o temporanei vengono ignorati e il post viene programmato senza contenuti multimediali. Per allegare contenuti multimediali, preparali prima di chiamare l'endpoint di programmazione:

Normalizza l'URL del contenuto multimediale con una richiesta GET, in modo che il file venga ospitato sui server Metricool quando necessario:
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>
Fai riferimento al contenuto multimediale nel post tramite il relativo mediaId:
"media": { "mediaId": "ID_OF_MEDIA" }

Se nella richiesta manca l'identificatore del contenuto multimediale, il post viene programmato senza contenuti multimediali. Consulta l'esempio completo in Domande frequenti ed errori comuni nell'uso dell'API.

Limitazioni della pubblicazione

Ogni social network limita ciò che gli strumenti di terze parti possono pubblicare tramite la propria API, quindi non tutte le funzioni del planner sono disponibili attraverso l'API di Metricool. Per l'elenco delle azioni di pubblicazione, Inbox e Reporting non supportate per ciascun social network, consulta Limitazioni dell'API per social network.

Anche i campi specifici dei vari social network nel corpo della richiesta variano in base al network. Prima di creare la richiesta, consulta i file Swagger .yaml e .json nella documentazione API per verificare i campi disponibili per ciascun network.

Implementazione dell'API

Per esportare dati da Metricool usando la nostra API verso altre piattaforme, come Excel, Google Sheets, MySQL e altre, segui questi passaggi generali:

Ottieni il token di accesso da Impostazioni account > API, come descritto sopra.
Configura il client HTTP: usa uno strumento di integrazione come Postman o un linguaggio di programmazione (ad esempio Python con requests) e configura l'header X-Mc-Auth con il tuo token.
Invia una richiesta GET all'endpoint relativo ai dati che vuoi ottenere (post, metriche, report). Tutte le chiamate richiedono userId e blogId. Usa l'ispettore del browser per visualizzare le chiamate effettuate da Metricool e i relativi parametri, come mostrato in Come ottenere un endpoint in Metricool per effettuare chiamate API.
Formatta i dati: le risposte sono generalmente in formato JSON, quindi associa i campi alla struttura prevista dalla piattaforma di destinazione.
Esporta i dati nella piattaforma di destinazione.

Ogni piattaforma di destinazione ha un proprio metodo di integrazione, ma il flusso generale segue questo schema.

Documentazione

Ecco i link alla documentazione delle API delle piattaforme più utilizzate per la gestione dei dati:

Monitora l'utilizzo e sostituisci il token

Impostazioni account > API mostra l'utilizzo attuale dell'API e la cronologia degli endpoint utilizzati. Puoi anche recuperare le statistiche di utilizzo tramite l'API con GET /v2/settings/users/{userId}/api-usage-stats, che accetta i parametri from, to e aggregation e restituisce le chiamate effettuate per endpoint.

Se devi sostituire il token, puoi rigenerarlo da Impostazioni account > API. La rigenerazione invalida immediatamente il token precedente e ogni integrazione che lo utilizza smette di funzionare finché non lo aggiorni. Consulta Rigenera il token della connessione API.

Articoli correlati

È stato utile?