Guida API Pinterest per sviluppatori (2026)

L’API Pinterest v5 crea pin per te, inclusi i video pin, ma solo dopo che la tua app supera una revisione. Fino ad allora la tua app resta in accesso trial, dove ogni pin e bacheca che crea è un’entità sandbox visibile solo al suo creatore. Questo unico fatto decide se l’API ti è utile, quindi merita di stare in cima piuttosto che nascosto in una sezione sugli scope.

Cosa può pubblicare davvero l’API Pinterest?

Crea pin sulle bacheche possedute dall’account autenticato: pin immagine e pin video, con titolo, descrizione e link di destinazione. È un’API di pubblicazione, non di navigazione, ed è vincolata agli account che hanno autorizzato la tua app.

Le lacune che contano per una valutazione:

Quindi uno strumento interno che usi sul tuo account può restare in accesso trial a tempo indeterminato. Un prodotto che pubblica per conto di clienti non può, perché i pin trial non diventano mai visibili.

Nota: questi dati sono stati verificati su developers.pinterest.com a settembre 2026. Le piattaforme li cambiano senza preavviso.

Cosa richiede la revisione dell’app Pinterest e quanto tempo serve?

Registri un’app, ottieni l’approvazione per l’accesso trial, poi richiedi l’aggiornamento allo standard. La documentazione di Pinterest afferma che l’aggiornamento richiede che la tua app abbia già l’approvazione trial, rispetti le linee guida per sviluppatori, e che tu fornisca una registrazione video della tua app mentre completa un’azione tramite l’API Pinterest, con il flusso di autenticazione dell’utente visibile nella registrazione. Le registrazioni schermo di chiamate da terminale o Postman sono formati accettati.

Il motivo di rifiuto più comune indicato da Pinterest è una demo che non mostra il flusso OAuth, o che non mostra un’integrazione Pinterest live all’interno dell’applicazione.

Sui tempi: Pinterest dice che le richieste di aggiornamento standard sono “revisionate regolarmente” e che vieni avvisato via email quando viene presa una decisione. Suggerisce di prevedere alcuni giorni. Non è pubblicato alcun tempo di attesa preciso, quindi tratta qualsiasi numero preciso che leggi altrove come una supposizione. Pianifica la data di lancio attorno a un’incognita, non a un SLA promesso.

Il modello di autenticazione in sé è un normale OAuth 2.0: reindirizzi l’utente verso Pinterest, scambi il codice con un access token e un refresh token, memorizzi entrambi per account, li rinnovi prima della scadenza. Niente di esotico. La parte esotica è la revisione che sta davanti a tutto questo.

Qual è la sequenza effettiva per creare un pin?

Per un pin immagine con sorgente da un URL pubblico, è una sola chiamata. Per un pin video sono quattro passaggi, perché i byte devono essere registrati, caricati ed elaborati prima che un pin possa farvi riferimento.

1. Registra il caricamento media. POST /v5/media con il tipo di media. La risposta contiene un identificativo media, un URL di caricamento e un insieme di parametri form.
2. Carica i byte. Fai un POST di un form multipart a quell’URL di caricamento, inviando prima i parametri restituiti come campi form e per ultimo il file. È un post form presigned in stile S3, non un endpoint Pinterest, quindi le sue risposte di errore sono XML anziché JSON.
3. Interroga lo stato del media. Rileggi il record media finché l’elaborazione non è andata a buon fine. Un 2xx dal caricamento non significa che il video sia utilizzabile.
4. Crea il pin. POST /v5/pins facendo riferimento al media elaborato, più bacheca, titolo, descrizione e link.

# 1. register
curl -X POST https://api.pinterest.com/v5/media \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_type":"video"}'

# 2. upload the bytes to the returned upload_url,
#    sending every returned upload parameter as a form field first
curl -X POST "$UPLOAD_URL" \
  -F key="$KEY" -F policy="$POLICY" -F "x-amz-signature=$SIG" \
  -F file=@clip.mp4

# 3. poll until the media reports a succeeded status
# 4. create the pin referencing that media id

Nota: non siamo riusciti a verificare i nomi esatti dei campi di richiesta e risposta per POST /v5/media o POST /v5/pins rispetto al riferimento ufficiale dell’API Pinterest: quelle pagine renderizzano il contenuto lato client e non hanno restituito testo di documentazione al momento del recupero. Leggi il riferimento API live su developers.pinterest.com prima di scrivere codice contro di esso, e considera i nomi dei campi sopra come la forma del flusso piuttosto che uno schema copiabile.

Il passaggio che le persone saltano è il terzo. Un pin video richiede anche un’immagine di copertina, che è un secondo asset da produrre e validare. Non siamo riusciti a confermare il requisito esatto della copertina su una pagina di riferimento v5 recuperabile, quindi verificalo rispetto alla documentazione attuale prima di costruirci sopra. Se stai dimensionando immagini per entrambi i tipi di pin, la nostra guida dimensioni pin Pinterest ha le dimensioni attuali.

Quali sono i rate limit dell’API Pinterest?

I limiti pubblicati differiscono nettamente per livello, un altro motivo per cui l’accesso trial non è un’anteprima del comportamento in produzione.

Le singole categorie di endpoint hanno budget propri più stretti oltre a quello universale: lettura, scrittura, analitica e conversioni hanno ciascuna il proprio budget, e la documentazione di Pinterest stessa nota che tutti i rate limit sono soggetti a modifiche senza preavviso. Controlla la categoria assegnata a ogni endpoint che chiami piuttosto che dare per scontato che si applichi il numero universale.

Nota: questi dati sono stati verificati su developers.pinterest.com a settembre 2026. Le piattaforme li cambiano senza preavviso.

Cosa ti costerà davvero tre settimane

Non la chiamata per creare il pin. Quella è questione di un pomeriggio. Le tre settimane sono qui:

• La revisione. Non puoi rilasciare ai clienti in accesso trial, e non esiste un tempo di attesa pubblicato. Invia presto, e invia una registrazione che mostri chiaramente il flusso OAuth, perché è la modalità di fallimento nominata.
• Il rinnovo dei token. I refresh token scadono e le revoche avvengono silenziosamente. Ti serve un refresh token memorizzato per ogni account collegato, un processo che li rinnova prima della scadenza, e uno stato “riconnetti questo account” nella tua interfaccia. Costruire tutto questo dopo la morte del primo token di un cliente è l’ordine più costoso.
• La transcodifica dei media. I video pin significano accettare qualsiasi cosa carichi un utente, normalizzare codec e contenitore, generare un’immagine di copertina, e memorizzare il risultato da qualche parte da cui il passaggio di caricamento possa fare lo streaming. Quella è una pipeline media, non un’integrazione API.
• La gestione dei fallimenti asincroni. Un 2xx dal caricamento presigned significa che i byte sono arrivati. Non significa che il video sia stato elaborato, e non significa che esista un pin. Ti serve un poller di stato, una politica di retry che distingua i fallimenti transitori da quelli permanenti, e uno stato del post che possa essere processing anziché solo pubblicato o fallito. Abbiamo scritto di quel modello di stato nella guida all’API di programmazione social media.

Moltiplica tutti e quattro per ogni piattaforma che aggiungi. Questa è la vera forma del progetto. Il confronto costruire vs comprare ci mette dei numeri intorno.

La versione breve

• L’accesso trial è quello predefinito e produce pin sandbox visibili solo al loro creatore. L’accesso standard richiede una revisione con una demo video del flusso OAuth. Nessun tempo di attesa è pubblicato.
• I pin immagine da un URL pubblico sono una sola chiamata. I pin video sono registra, carica, interroga, crea, più un’immagine di copertina.
• Il trial è limitato a 1.000 richieste al giorno per app. Lo standard è 100 richieste al secondo per utente per app, con limiti per categoria più stretti sotto.
• Il costo ingegneristico è la revisione, il rinnovo dei token, la transcodifica e la gestione dei fallimenti asincroni, non la chiamata di pubblicazione.

Farlo una volta invece che per ogni piattaforma

Se Pinterest è una delle diverse reti di cui hai bisogno, il lavoro per piattaforma di cui sopra si ripete con forme diverse ogni volta: revisioni diverse, flussi media diversi, modelli di quota diversi. È esattamente ciò che la nostra API esiste per assorbire. BulkPublish pubblica su 15 piattaforme tramite un unico endpoint REST e un unico modello di post, con OAuth, rinnovo dei token, gestione dei media e monitoraggio dello stato asincrono dalla nostra parte.

La documentazione per sviluppatori e la pagina di integrazione REST API coprono gli endpoint e il ciclo di vita del post. Se preferisci programmare i pin tramite un’interfaccia piuttosto che scrivere codice contro l’una o l’altra API, come programmare i pin Pinterest copre quel percorso, e il contatore di caratteri Pinterest gratuito manterrà i tuoi titoli e le tue descrizioni entro i limiti.

Correlati

• Guida completa all’API di programmazione social media
• Costruire o comprare: un’API di pubblicazione social media
• Rate limit delle API social media
• Come programmare i pin Pinterest
• Dimensioni pin Pinterest