API Tutorial

Come ottenere le analitiche di Pinterest tramite API

Per ottenere le analitiche di Pinterest tramite API, collega Pinterest con Modiva e poi chiama `analytics_unified` — restituisce reach, impression, engagement e metriche sui follower in una forma normalizzata che puoi visualizzare o analizzare.

Ogni piattaforma riporta le metriche in modo diverso, quindi il reporting cross-piattaforma di solito richiede un livello di mapping per ogni rete. Lo strumento `analytics_unified` di Modiva restituisce le metriche di Pinterest nello stesso schema di ogni altra piattaforma, così una singola query alimenta un'intera dashboard.

Passo dopo passo

Crea un account Modiva e una chiave MCP

Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.

Collega il tuo account Pinterest

Nella dashboard clicca su Collega e scegli Pinterest. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di Pinterest. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.

Chiama analytics_unified per le metriche di Pinterest

Chiama `analytics_unified` con l'ID della connessione, le metriche che desideri e un intervallo di tempo. Modiva le recupera da Pinterest, normalizza i nomi dei campi e restituisce una forma JSON coerente, pronta da visualizzare.

Unisci ogni piattaforma in un unico report

Passa più ID di connessione per combinare Pinterest con il resto del tuo stack in un'unica risposta. Tramite MCP un agente può recuperare i numeri e scrivere il report settimanale per te, poi chiamare `analytics_best_time_to_post` per pianificare il prossimo.

Richiesta di esempio

Chiama lo strumento analytics_unified tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "analytics_unified",
    "connectionId": "conn_…",
    "args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
  }'

Provalo con Pinterest

Inizia gratis

FAQ

Le metriche di Pinterest sono confrontabili con quelle delle altre piattaforme?

Sì — Modiva normalizza le analitiche di Pinterest in uno schema comune, così reach ed engagement combaciano su ogni rete collegata.

Un agente IA può generare il report?

Sì. Esponi `analytics_unified` tramite MCP e un agente può recuperare i numeri di Pinterest e comporre la sintesi in autonomia.

Continua a costruire con Pinterest

Integrazione API Pinterest Server MCP Pinterest Come pubblicare su Pinterest tramite API Come pianificare i post su Pinterest tramite API Come leggere e rispondere ai commenti su Pinterest tramite API Come ottenere le analitiche di Instagram tramite API Come ottenere le analitiche di TikTok tramite API