Pinterest
BulkPublish
API di Pinterest
Pubblica, programma e gestisci Pinterest dal tuo codice. Una sola REST API e una sola chiave coprono Pinterest e ogni altra rete che colleghi, così scrivi l’integrazione una volta sola.
Cosa copre l’API di Pinterest
Tutto ciò che segue fa parte dell’API pubblicata e oggi funziona con Pinterest.
| Funzione | Endpoint |
|---|---|
| Crea, programma, modifica e pubblica post | POST /api/posts |
| Carica immagini e video | POST /api/media |
| Trova il prossimo slot libero nella tua coda | GET /api/posts/queue-slot |
| Crea programmazioni ricorrenti | POST /api/schedules |
| Pubblica i nuovi elementi di un feed RSS | POST /api/rss-feeds |
| Cerca bacheche di Pinterest per un canale | GET /api/channels/{id}/options |
| Leggi le metriche di ogni post | GET /api/posts/{id}/metrics |
| Controlla che la connessione funzioni | GET /api/channels/{id}/health |
| Controlla l’utilizzo del tuo piano | GET /api/quotas/usage |
Tipi di post che puoi pubblicare su Pinterest
Scegli il tipo con postTypeOverrides. Un tipo che Pinterest non offre viene rifiutato prima che qualcosa finisca in coda.
| Tipo di post | Media |
|---|---|
pin Pin | Obbligatorio: 1 immagine |
video_pin Video Pin | Obbligatorio: 1 video |
carousel Carousel | Obbligatorio: da 2 a 5 immagini |
Programma un post su Pinterest con curl
Tre richieste: trova il tuo canale, carica il file se il post ne ha uno, poi crea il post. Sostituisci la chiave con una creata in Impostazioni, poi Chiavi API, e 12 con l’id del tuo canale.
1. Elenca i tuoi canali e annota l’id del tuo account Pinterest.
curl https://app.bulkpublish.com/api/channels \
-H "Authorization: Bearer bp_your_key_here" 2. Carica il file. La risposta ti dà l’id del media da usare come mediaFiles qui sotto.
curl -X POST https://app.bulkpublish.com/api/media \
-H "Authorization: Bearer bp_your_key_here" \
-F "file=@photo.jpg" 3. Crea il post.
curl -X POST https://app.bulkpublish.com/api/posts \
-H "Authorization: Bearer bp_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"content": "A 20 minute pasta for busy evenings",
"channels": [{ "channelId": 12 }],
"status": "scheduled",
"scheduledAt": "2026-12-01T09:00:00Z",
"mediaFiles": [101],
"platformSpecific": {
"pinterest": {
"12": {
"boardId": "BOARD_ID"
},
"title": "Weeknight pasta",
"link": "https://example.com/pasta"
}
}
}' La risposta è il post creato, con il suo id e lo stato. Recuperalo più tardi con GET /api/posts/{id} per vedere com’è andata.
Opzioni di Pinterest
Inviale dentro platformSpecific, sotto la chiave di Pinterest.
Per Pinterest le opzioni sono indicate per id del canale, per esempio "12", oppure inviate senza chiave per valere su ogni canale Pinterest del post.
| Opzione | Cosa fa | Accetta |
|---|---|---|
title | Titolo | testo |
description | Descrizione | testo |
link | Link di destinazione | testo |
dominantColor | Colore di sfondo del pin | testo |
coverImageUrl | Immagine di copertina per i pin video | testo |
boardId | Bacheca in cui fissare il pin | testo |
Per trovare bacheche validi per un canale, chiama GET /api/channels/{id}/options.
Analisi di Pinterest tramite API
Queste metriche tornano per ogni post di Pinterest su GET /api/posts/{id}/metrics, con rilevazioni nel tempo.
- Impression
- Clic
- Salvataggi
- Visualizzazioni video
- Mi piace
- Commenti
- Tasso di interazione
Commenti e messaggi
BulkPublish non legge commenti né messaggi su Pinterest, quindi qui non c’è nulla da elencare o a cui rispondere.
Accesso all’API su ogni piano
Ogni piano include le chiavi API, anche il piano Free. Ecco cosa consente ciascuno.
| Piano | Chiavi API | Richieste al giorno |
|---|---|---|
| Free | 1 | 30 |
| Pro | 5 | 5000 |
| Business | 10 | 50.000 |
Costruisci direttamente su Pinterest oppure usa BulkPublish
Lavorare direttamente è una scelta sensata, soprattutto se ti serve qualcosa che BulkPublish non offre. Ecco cosa ti chiede Pinterest API v5, verificato sulla sua documentazione a ottobre 2026.
- Prima di pubblicare devi registrare un’app per sviluppatori presso Pinterest.
- I token di accesso durano circa 30 giorni, quindi ti serve un modo tuo per rinnovarli o ricollegare l’account prima che scadano.
BulkPublish mantiene la connessione per te: rinnova i token, controlla ogni post rispetto alle regole di Pinterest prima che finisca in coda e segnala sul post una destinazione fallita, così il tuo codice fa una sola richiesta.
Leggi la documentazione ufficiale
Preferisci chiedere a un assistente?
Claude, ChatGPT e Cursor possono fare lo stesso tramite il server MCP per Pinterest, con richieste in linguaggio naturale al posto del codice.
Vedi il server MCP per Pinterest
Preferisci un calendario al codice?
Lo stesso account Pinterest si può programmare dall’app, con un calendario dei contenuti e il caricamento in blocco.
Vedi il pianificatore per Pinterest
Domande frequenti
Le domande più comuni sull’API di Pinterest.
Esiste un’API di Pinterest che posso usare senza costruire io l’integrazione?
Sì. BulkPublish espone Pinterest tramite la sua REST API. Collega il tuo account Pinterest una volta sola, poi pubblica, programma e gestisci tutto con una chiave. La stessa chiave vale per ogni altra rete che colleghi.
Cosa posso pubblicare su Pinterest tramite l’API?
I tipi di post sono Pin, Video Pin e Carousel. Ognuno viene controllato rispetto alle regole sui media di Pinterest prima di finire in coda, quindi una richiesta che Pinterest rifiuterebbe fallisce subito con un errore chiaro.
Posso programmare i post di Pinterest tramite l’API?
Sì. Invia status "scheduled" con un orario scheduledAt e un timezone, oppure chiedi prima il prossimo slot libero nella tua coda. Sono disponibili anche programmazioni ricorrenti e feed RSS.
Posso leggere le analisi di Pinterest tramite l’API?
Sì. Le metriche dei singoli post includono Impression, Clic, Salvataggi, Visualizzazioni video, Mi piace, Commenti e Tasso di interazione, con rilevazioni nel tempo.
Posso leggere e rispondere ai commenti o ai messaggi di Pinterest tramite l’API?
No. BulkPublish non legge commenti né messaggi su Pinterest.
L’API di Pinterest costa extra?
No. L’accesso all’API è su ogni piano. Free include 1 chiave e 30 richieste al giorno, Pro 5 chiavi e 5000 al giorno, Business 10 chiavi e 50.000 al giorno.
Mi serve un account sviluppatore Pinterest o una revisione dell’app?
Non per usare BulkPublish. Colleghi il tuo account Pinterest dalla pagina Canali e pubblichi con una chiave BulkPublish. Se invece costruisci sull’API di Pinterest, la sezione qui sopra elenca cosa ti chiede.
Può farlo anche un assistente IA?
Sì. La pagina del server MCP per Pinterest mostra come collegare Claude, ChatGPT o Cursor e cosa chiedere.
Altre reti
La stessa chiave e la stessa forma di richiesta funzionano per 15 reti.
Inizia a pubblicare su Pinterest dal codice
Crea un account gratuito, collega Pinterest e genera una chiave. Nessuna carta richiesta.