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.

Integrazione di Pinterest con BulkPublish

Cosa copre l’API di Pinterest

Tutto ciò che segue fa parte dell’API pubblicata e oggi funziona con Pinterest.

FunzioneEndpoint
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 postMedia
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.

OpzioneCosa faAccetta
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.

PianoChiavi APIRichieste 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.

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.

Preferisci un calendario al codice?

Lo stesso account Pinterest si può programmare dall’app, con un calendario dei contenuti e il caricamento in blocco.

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.

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.