API Tutorial
Come pubblicare su Pinterest tramite API
Per pubblicare su Pinterest tramite API, collega l'account Pinterest con Modiva (che gestisce OAuth e scope) e poi chiama lo strumento `posts_create` con il tuo testo e i tuoi media — Modiva lo pubblica su Pinterest e restituisce l'ID del post.
L'API di Pinterest richiede la revisione dell'app, la gestione di OAuth e i permessi di pubblicazione corretti prima ancora di poter pubblicare un solo aggiornamento. Modiva si occupa di tutto questo per te e mette a disposizione un unico strumento `posts_create` che pubblica su Pinterest (e su ogni altra piattaforma collegata) nello stesso modo.
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 posts_create per pubblicare su Pinterest
Chiama lo strumento `posts_create` con l'ID della connessione e il tuo contenuto. Modiva verifica il payload rispetto alle regole di formato di Pinterest (lunghezza, tipi di media, proporzioni) e pubblica immediatamente, restituendo l'ID e l'URL del post live.
Fai di più — pianifica, cross-posta, automatizza
La stessa chiamata alimenta un agente IA tramite MCP: indirizza Claude o Cursor su `https://mcp.modiva.ai/v1` e potrà pubblicare su Pinterest per tuo conto. Sostituisci `posts_create` con `posts_schedule` per metterlo in coda, oppure `posts_cross_post` per diffondere un post su ogni piattaforma in una volta sola.
Richiesta di esempio
Chiama lo strumento posts_create tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Provalo con Pinterest
Inizia gratisFAQ
Ho bisogno di un'app per sviluppatori Pinterest per pubblicare tramite API?
No. Modiva possiede l'app Pinterest già approvata e gestisce OAuth, così ti colleghi con un clic e parti subito — nessuna revisione dell'app, nessuna complicazione con gli scope.
Un agente IA può pubblicare su Pinterest per me?
Sì. Lo stesso strumento `posts_create` è esposto tramite il Model Context Protocol, così qualsiasi client MCP (Claude, Cursor e simili) può pubblicare su Pinterest non appena aggiungi la tua chiave MCP di Modiva.