Blog

Pianifica i Pin di Pinterest tramite API: Guida per Sviluppatori

Scopri come programmare i Pin di Pinterest tramite API con la nostra guida completa per sviluppatori. Include autenticazione, esempi di codice, gestione degli e

Di

+8

Pubblica ovunque. Una API.

Try Free

Se sei serio riguardo alla crescita su Pinterest, utilizzare un'API per programmare i tuoi pin è l'unico modo per farlo su larga scala. Ti permette di superare i limiti manuali del pianificatore nativo, costruire un vero e proprio flusso di contenuti e sfruttare il potenziale di traffico a lungo termine della piattaforma.

Perché automatizzare la programmazione su Pinterest con un'API

Laptop displaying a content scheduling calendar, a plant, and a smartphone on a desk, with an 'Automate Pins' sign.

Pinterest non è come le altre piattaforme social. Pensala come un motore di scoperta visiva dove i tuoi contenuti hanno una durata incredibilmente lunga. Un tweet o un post su Instagram diventano storia antica dopo poche ore, ma un buon Pin può continuare a generare traffico per mesi, addirittura anni. Questo valore a lungo termine è esattamente il motivo per cui una strategia di pinning coerente e ad alto volume funziona così bene.

Ma siamo realisti: fissare manualmente 5-25 pubblicazioni al giorno, che è ciò di cui hai bisogno per una crescita seria, è una ricetta per il burnout. Qui è dove l'automazione guidata da API smette di essere un'opzione e diventa una necessità strategica. Stai essenzialmente trasformando la tua strategia su Pinterest da una serie di clic manuali in un flusso di lavoro programmabile e scalabile.

Superare i limiti di programmazione nativa

Il pianificatore integrato di Pinterest non è affatto all'altezza per un uso professionale. È pieno di limitazioni. Ad esempio, storicamente sei stato costretto a pianificare solo 100 Pin a la volta, e solo all'interno di un intervallo ristretto. 2-4 finestra di una settimana. Questo rende impossibile creare il tipo di calendario dei contenuti a lungo termine che Pinterest stesso raccomanda.

Per comprendere davvero perché questo sia importante, è utile capire il concetto di automazione dei flussi di lavoroNon si tratta solo di risparmiare qualche minuto qua e là; si tratta di costruire un sistema che sia sia efficiente che resiliente.

Il principale vantaggio dell'utilizzo di un'API è superare le limitazioni dell'interfaccia utente della piattaforma. Puoi pianificare migliaia di Pin con mesi di anticipo, gestire più account in modo programmatico e integrare Pinterest direttamente nei tuoi sistemi di gestione dei contenuti esistenti.

Il Valore Strategico dell'Automazione

Quando scegli di programma i pin di Pinterest tramite un'APIstai sbloccando vantaggi davvero significativi:

  • Scalabilità: Pubblica contenuti a un ritmo che sarebbe fisicamente impossibile per un essere umano gestire, mantenendo un flusso costante di nuovi Pin.
  • Coerenza: Stabilisci un programma di pubblicazione prevedibile. L'algoritmo di Pinterest lo adora ed è fondamentale per far vedere i tuoi contenuti.
  • Efficienza: Integra la creazione e la programmazione dei tuoi Pin in altri flussi di lavoro automatizzati, come il prelievo delle immagini dei prodotti direttamente da un database e-commerce.
  • Flessibilità: Hai bisogno di aggiornare link, descrizioni o bacheche in massa? Puoi farlo in modo programmatico senza dover accedere e modificare ogni Pin manualmente.

Non è un concetto nuovo: è una strategia collaudata utilizzata anche su altre piattaforme. Per un approccio simile, dai un'occhiata alla nostra guida su come https://getlate.dev/blog/schedule-twitter-postsIn definitiva, l'automazione è il ponte tra una strategia Pinterest efficace e una che può realmente crescere insieme ai tuoi obiettivi.

Iniziare con l'autenticazione dell'API di Pinterest

Prima di poter programmare il tuo primo Pin, la tua app deve ottenere il permesso di pubblicare a nome di un utente. Qui entra in gioco il sistema di autenticazione dell'API di Pinterest, ed è tutto basato sugli standard del settore. OAuth 2.0 framework. Pensalo come una stretta di mano sicura che garantisce agli utenti di sapere esattamente cosa fa la tua app e di acconsentire esplicitamente a questo.

Impostare tutto questo potrebbe sembrare un po' intimidatorio, ma il flusso è piuttosto logico. Prima di tutto, dovrai registrare la tua applicazione su Sviluppatori di Pinterest piattaforma. Qui otterrai il tuo unico client_id and client_secret—fondamentalmente, il nome utente e la password della tua app per comunicare con l'API.

Analisi del flusso OAuth 2.0

Alla base, OAuth 2.0 è progettato in modo che tu non debba mai chiedere la password reale dell'utente su Pinterest. Invece, la tua app li indirizza a una pagina di autorizzazione speciale di Pinterest. Su quella pagina, l'utente vede un elenco chiaro delle autorizzazioni richieste dalla tua app e può scegliere di approvare o negare l'accesso. È trasparente e sicuro.

Se cliccano su approva, Pinterest li rimanda a un redirect_uri che hai configurato quando hai impostato la tua app. Nella redirect è nascosto un codice di autorizzazione temporaneo. Il backend della tua app acquisisce questo codice e lo scambia—insieme alle tue credenziali client—per un token di accesso e un token di aggiornamentoQuel token di accesso è la chiave d'oro che utilizzerai per tutte le future chiamate API.

Definire i tuoi ambiti (ovvero Richiedere Permessi)

Quando avvii il processo di autorizzazione, devi essere chiaro riguardo ai permessi, altrimenti scopes, la tua app ha bisogno. Questo è fondamentale. Dovresti chiedere solo ciò di cui hai assolutamente bisogno per programmare i Pin. Richiedere un elenco lungo di autorizzazioni fin dall'inizio può spaventare gli utenti e portare a negare l'accesso.

Per il nostro obiettivo di pianificare i pin, due ambiti sono assolutamente fondamentali.

Prima di entrare nel vivo, diamo un'occhiata ai permessi chiave di cui la tua app avrà bisogno per leggere i dati delle bacheche e creare nuovi Pin per conto di un utente.

Scope OAuth 2.0 essenziali per l'API di Pinterest

Queste sono le autorizzazioni chiave di cui la tua app avrà bisogno per leggere i dati delle bacheche e creare nuovi Pin per un utente.

ScopeDescriptionQuando usarlo
boards:leggiConsente alla tua app di recuperare un elenco delle bacheche di un utente, inclusi i loro nomi e ID.Hai bisogno di questo per ottenere il board_id dove verrà salvato il Pin. È un prerequisito per creare un Pin.
scrivere pinConcede il permesso di creare nuovi Pin per conto dell'utente.Questo è l'ambito principale necessario per effettivamente programma i pin di Pinterest tramite l'API.

Impostare correttamente gli ambiti fin dall'inizio crea fiducia nei tuoi utenti. Se in seguito aggiungi ulteriori funzionalità, come la lettura delle analisi dei Pin, puoi sempre aggiornare la tua richiesta di ambito. Ricorda solo che gli utenti esistenti dovranno ripetere il processo di autenticazione per concedere queste nuove autorizzazioni.

Il mio consiglio? Inizia sempre con le funzionalità minime necessarie. È un'esperienza molto più fluida per l'utente e rende la tua app più affidabile.

Come Gestire i Tuoi Token in Sicurezza

Una volta che l'utente dà il via libera alla tua app, ricevi due informazioni fondamentali: il token di accesso e il token di aggiornamento. Il token di accesso è quello che dovrai includere nel Authorization intestazione per le tue richieste API, come questa: Autorizzazione: Bearer <YOUR_ACCESS_TOKEN>.

Questi token di accesso sono progettati per avere una durata limitata per motivi di sicurezza: di solito scadono dopo un certo periodo di tempo. È qui che entra in gioco il token di aggiornamento salva la situazione.

Invece di costringere l'utente a effettuare nuovamente il login ogni volta che un token di accesso scade, puoi utilizzare il token di aggiornamento per richiedere silenziosamente un nuovo token di accesso dall'API in background. Questo crea una connessione fluida e a lungo termine al loro account senza compromettere la sicurezza.

È assolutamente fondamentale memorizzare questi token di aggiornamento in modo sicuro nel tuo database. Crittografarli a riposo non è solo una buona idea; è un passo indispensabile. Questi token forniscono accesso continuo, quindi se uno viene perso o compromesso, l'utente dovrà ripetere l'intero processo di OAuth 2.0. Gestire correttamente questo ciclo di gestione dei token è la chiave per costruire un'integrazione con Pinterest che sia sia affidabile che sicura.

Bene, hai gestito il processo di autenticazione OAuth 2.0 e hai ottenuto il tuo token. Ora arriva la parte divertente: creare e programmare il tuo primo Pin. Tutto questo avviene inviando un POST richiesta all'API di Pinterest /it/pins endpoint con un payload JSON che funge da modello per il tuo Pin.

Ottenere questo payload corretto è fondamentale. Definisce su quale bacheca si trova il Pin, quale immagine viene visualizzata e a quale link si collega. I campi principali, non negoziabili, sono i board_id, il sorgente_media oggetto (dove si trova la tua immagine o video) e la destinazione link.

L'intero processo è piuttosto semplice. La tua app utilizza il token appena ottenuto per dimostrare di avere il permesso di agire per conto dell'utente.

Diagram illustrating the API authentication process flow from an App through User Authentication to a Token.

Con quel token in mano, sei pronto per iniziare a costruire il Pin stesso.

Creare il Payload del Pin

Analizziamo il JSON che invierai. Pensa a questo come a mescolare gli ingredienti per il tuo Pin.

  • board_idQuesto è semplicemente l'ID unico per la bacheca a cui stai appuntando. Dovrai ottenerlo in anticipo effettuando una chiamata API separata per elencare le bacheche dell'utente (che, ricorda, richiede il boards:leggi ambito).
  • linkL'URL completo a cui vuoi indirizzare il traffico. Un consiglio rapido ma fondamentale: Pinterest è molto selettivo su questo. Assicurati che sia un URL diretto e completo, poiché non funziona bene con i servizi di accorciamento link.
  • sorgente_mediaQuesto è un oggetto, non solo una semplice stringa. Indica a Pinterest dove trovare l'immagine del tuo Pin. Il metodo più comune qui è utilizzare un image_url.

The origine_media l'oggetto è dove avviene la magia per i tuoi contenuti visivi. È flessibile, ma nella maggior parte dei casi, punterai a un'immagine che hai ospitato da qualche parte.

{
"board_id": "IL_TUO_ID_DELLA_BOARD_QUI",
"link": "https://yourwebsite.com/blog/your-awesome-post",
"media_source": {
"source_type": "image_url",
"url": "https://cdn.yourdomain.com/images/your-pin-image.jpg"
}
}
Qui stiamo comunicando esplicitamente all'API che il tipo_fonte è un image_url e poi fornendo al pubblico url per Pinterest da recuperare. È il modo più diretto per portare a termine il lavoro.

Ottimizza il tuo Pin per una maggiore visibilità

Certo, i campi di base ti permetteranno di pubblicare il tuo Pin, ma lasceresti un sacco di valore inutilizzato. Se vuoi che i tuoi Pin vengano realmente scoperti, devi includere i campi opzionali: description and testo_alternativo.

Un buon description è la tua opportunità per il SEO. Riempi il tuo contenuto di parole chiave pertinenti per aiutare le persone a trovarlo attraverso la ricerca. Il testo_alternativo è altrettanto fondamentale, sia per l'accessibilità (descrivere l'immagine agli utenti non vedenti) sia come un ulteriore segnale forte per l'algoritmo di Pinterest riguardo al contesto del tuo contenuto.

Un errore comune che vedo fare agli sviluppatori è saltare il testo_alternativo and description per mantenere il codice più pulito. Questa è una grande opportunità persa. I pin con descrizioni ricche e ottimizzate per le parole chiave vedono una distribuzione notevolmente migliore nel tempo.

La Magia della Programmazione con pubblica_a

Ora arriviamo al cuore dell'automazione: il pubblica_a parametro. Questo singolo campo trasforma una semplice richiesta di "crea Pin" in un potente strumento di programmazione. Aggiungendolo al tuo payload, indichi a Pinterest il momento esatto in cui desideri che il tuo Pin venga pubblicato.

L'API si aspetta questo timestamp in ISO 8601 formato. È uno standard universale che evita qualsiasi confusione con i fusi orari.

Un valido pubblica_a il valore appare in questo modo: 2025-12-25T14:30:00ZAnalizziamolo:

  • 2025-12-25 è la data.
  • T è solo un separatore.
  • 14:30:00 è in formato 24 ore.
  • Z sta per tempo Zulu, che significa UTC. Utilizzare l'UTC è il modo migliore per mantenere la tua programmazione coerente e prevedibile.

Colleghiamo questo al nostro payload completo.

{
"board_id": "IL_TUO_ID_DELLA_BOARD_QUI"
"link": "https://yourwebsite.com/blog/your-awesome-post"
"media_source": {
"source_type": "image_url",
"url": "https://cdn.yourdomain.com/images/your-pin-image.jpg"
},
"description": "Una guida dettagliata su come programmare i pin di Pinterest tramite API, con esempi di codice e migliori pratiche per gli sviluppatori."
"alt_text": "Un diagramma di flusso che mostra i passaggi per creare e programmare un pin su Pinterest utilizzando una chiamata API."
"publish_at": "2025-12-25T14:30:00Z"
}
Quando invii questo, Pinterest non lo pubblica immediatamente. Invece, viene messo in coda e verrà pubblicato automaticamente esattamente alle 14:30 UTC il giorno di Natale del 2025. Questo è il meccanismo principale che ti consente di programma i pin di Pinterest tramite APIUna volta che avrai padroneggiato questo payload, potrai creare un intero calendario dei contenuti con mesi di anticipo, offrendoti il pieno controllo sulla tua strategia di pinning.

Build faster with Late

One API call to post everywhere. No OAuth headaches. No platform-specific code.

Free tier • No credit card • 99.97% uptime

Gestire i limiti di frequenza dell'API e gli errori

Creare uno script per programmare un paio di Pin è una cosa. Sviluppare un'applicazione pronta per la produzione in grado di gestire volumi reali è tutta un'altra storia. La vera prova arriva quando le cose inevitabilmente vanno storte, ed è qui che una gestione intelligente degli errori e dei limiti di velocità diventa fondamentale.

Ogni API, incluso quello di Pinterest, stabilisce regole su quanto frequentemente puoi inviare richieste. Queste limiti di utilizzo sono delle protezioni per mantenere il servizio stabile per tutti. Se invii richieste senza prestare attenzione, è praticamente certo che la tua applicazione si bloccherà.

Fortunatamente, l'API ti offre gli strumenti per rispettare le regole. Dopo ogni richiesta andata a buon fine, dai un'occhiata agli header della risposta. Troverai due header che sono incredibilmente utili: X-RateLimit-Remaining and X-RateLimit-ResetIl primo ti indica quante chiamate ti rimangono nella finestra attuale, e il secondo è un timestamp Unix che ti dice quando quella finestra si resetta.

Comprendere gli errori comuni delle API

Monitorando questi header, la tua applicazione può rallentare in modo intelligente man mano che si avvicina al limite, evitando errori prima che si verifichino. È un approccio molto più intelligente rispetto a sbattere contro un muro e fallire.

Certo, anche con una pianificazione attenta, gli errori fanno parte della vita. L'errore più comune che puoi incontrare con il rate limiting è un 429 Troppi Richieste errore. Il tuo primo istinto potrebbe essere quello di ripetere immediatamente la richiesta—non farlo. Questo non farà altro che peggiorare la situazione. L'approccio professionale è implementare una strategia di ripetizione chiamata ritorno esponenziale.

Questo significa semplicemente che la tua applicazione attende un momento prima di riprovare. Se il secondo tentativo fallisce, raddoppia il tempo di attesa prima del terzo, e così via. Questa semplice tecnica consente all'API di respirare e aumenta notevolmente le possibilità che la tua prossima richiesta abbia successo.

La differenza tra uno script fragile e un'applicazione resiliente spesso risiede nella gestione degli errori. Gestire proattivamente i limiti di velocità e implementare una logica di ripetizione intelligente come il backoff esponenziale è ciò che distingue le integrazioni amatoriali da quelle professionali.

Una guida pratica al debug

Oltre ai limiti di frequenza, potresti incontrare altri codici di stato HTTP che segnalano problemi diversi. Un'applicazione solida sa come interpretarli e quali azioni intraprendere successivamente.

Ecco i soliti sospetti:

  • 400 Richiesta ErrataSi tratta di un classico errore di tipo "hai inviato qualcosa di sbagliato". Spesso indica un payload JSON malformato, un URL immagine non valido o un campo obbligatorio mancante come il board_idLa tua prima mossa dovrebbe essere quella di controllare attentamente il tuo payload rispetto alla documentazione ufficiale dell'API.
  • 401 Non autorizzatoQuesto riguarda esclusivamente l'autenticazione. Significa che il tuo token di accesso potrebbe essere scaduto, revocato, oppure hai semplicemente dimenticato di includerlo nel Authorization header. Questo è il segnale per utilizzare il tuo token di aggiornamento e ottenere un nuovo token di accesso.
  • 403 VietatoQuesto è un po' diverso da un 401. A 403 significa che l'API sa chi sei, ma non hai il permesso per ciò che stai cercando di fare. Una causa comune è il tentativo di creare un Pin quando alla tua app non è stato concesso il pins:scrivere ambito.
  • 500 Errore Interno del ServerQuesto errore non dipende da te, ma da Pinterest. Qualcosa è andato storto dalla loro parte. Quando succede, la strategia migliore è l'exponential backoff. Aspetta un attimo e riprova la richiesta.

Comprendere questi codici è fondamentale quando si programma i pin di Pinterest tramite un'API a qualsiasi scala. Puoi creare logiche che non solo registrano questi errori, ma che, in alcuni casi, tentano automaticamente di risolverli. E poiché le API sono in continua evoluzione, rimanere aggiornati su Migliori pratiche per la gestione delle versioni dell'API può farti risparmiare molti grattacapi in futuro.

Per aiutarti, ecco una tabella di riferimento rapida per gli errori più comuni che potresti incontrare.

Codici di errore comuni dell'API di Pinterest e relative soluzioni

Comprendere questi errori comuni ti aiuterà a creare un'applicazione di programmazione più robusta.

Codice di StatoMeaningCausa e Soluzione Comuni
400Richiesta non validaLa tua richiesta è malformata. Controlla se ci sono campi mancanti.board_id, link), formati media non corretti o JSON non valido. Confronta il tuo payload con la documentazione dell'API.
401UnauthorizedAutenticazione fallita. Il tuo token di accesso è probabilmente scaduto o non valido. Utilizza il tuo token di aggiornamento per ottenerne uno nuovo prima di riprovare.
403ForbiddenSei autenticato ma non hai i permessi necessari. Assicurati che la tua app abbia richiesto gli scope OAuth corretti, come pins:scrivereper l'azione che stai eseguendo.
429Troppe RichiesteHai raggiunto il limite di frequenza. Implementa il backoff esponenziale e utilizza X-RateLimit-Reset intestazione per sapere quando è sicuro riprovare.
500Errore interno del serverSi tratta di un problema lato server con Pinterest. La soluzione migliore è attendere e riprovare la richiesta più tardi, utilizzando nuovamente il meccanismo di backoff esponenziale.

Avere un piano per queste risposte fin dall'inizio renderà la tua applicazione infinitamente più affidabile e ti farà risparmiare innumerevoli ore di debug.

Semplifica il tuo flusso di lavoro con un'API unificata

A computer monitor displays various app icons, likely representing a unified API for different services, on a wooden desk.

Hai integrato direttamente l'API di Pinterest. È sicuramente un grande successo tecnico. Ma nella realtà, la tua strategia di contenuti probabilmente non si ferma a Pinterest. Cosa succede quando il tuo prodotto deve anche pubblicare su Instagram, X, LinkedIn e Facebook?

Improvvisamente, quella singola integrazione pulita si trasforma in un caos di molteplici flussi di autenticazione, strutture di payload estremamente diverse e un intero dizionario di codici di errore unici. Non si tratta solo di un mal di testa per gli sviluppatori, ma di un incubo per la manutenzione a lungo termine. Questo è esattamente il tipo di caos che un'API unificata per i social media è progettata per domare.

Il Potere dell'Astrazione

Invece di lottare con le API native di ciascuna piattaforma, un'API unificata funge da intermediario. Astrae tutte le peculiarità specifiche delle piattaforme e ti offre un'interfaccia unica e coerente con cui lavorare. Autenticati una sola volta, impara un insieme di endpoint e costruisci un unico tipo di payload.

Pensala in questo modo:

  • Senza un'API unificata: Sei un traduttore poliglotta, costretto a essere fluente in una dozzina di lingue diverse, ognuna con la propria grammatica e i propri idiomi confusi.
  • Con un'API unificata: Parli un'unica lingua, e l'API si occupa della traduzione su tutte le altre piattaforme per te.

Questo approccio riduce drasticamente il tempo di sviluppo iniziale. Puoi avere un'integrazione multi-piattaforma attiva in una frazione del tempo necessario per esaminare la documentazione di ciascun API nativo. Per un'analisi più approfondita su come questa centralizzazione si confronta con gli strumenti più popolari, dai un'occhiata alla nostra analisi di un Alternativa a Hootsuite con accesso API.

Il vero valore di un'API unificata non riguarda solo il risparmio di tempo iniziale. Si tratta di alleggerire il continuo onere della manutenzione delle API, che include il monitoraggio delle modifiche critiche, l'aggiornamento degli SDK e la gestione di più set di credenziali e logiche di refresh token.

Da Complesso a Coeso

Analizziamo la differenza. Per programma i pin di Pinterest tramite API gestisci direttamente il flusso OAuth 2.0 specifico di Pinterest, creando un payload con campi come board_id and sorgente_media, e decifrare gli errori specifici di Pinterest. Ora, per aggiungere LinkedIn, devi ricominciare da zero con un insieme completamente diverso di regole.

Un'API unificata standardizza l'intero processo.

FeatureAPI Nativa DirettaApproccio API Unificato
AuthenticationFlusso OAuth 2.0 separato per ogni piattaforma.Un processo di autenticazione unico e standardizzato.
Creazione PostStrutture di payload JSON specifiche per piattaforma.Un payload coerente per tutte le piattaforme.
Gestione degli ErroriCodici e messaggi di errore unici per ogni API.Risposte agli errori standardizzate e prevedibili.
MaintenanceMonitoraggio costante di più changelog API.Il fornitore dell'API gestisce tutti gli aggiornamenti della piattaforma.

Questo cambiamento ti permette di smettere di preoccuparti delle meccaniche di integrazione e iniziare a concentrarti sulla creazione di funzionalità straordinarie per i tuoi utenti. Per avere una visione più ampia su come semplificare questo tipo di operazioni, è utile comprendere il nucleo. principi di gestione efficace del flusso di lavoro nel marketing.

Affidabilità su larga scala

Costruire uno strato di programmazione affidabile va oltre il semplice invio di chiamate API. Hai bisogno di un'infrastruttura in grado di gestire i fallimenti in modo elegante, di gestire i limiti di richiesta in modo intelligente e di pubblicare i post esattamente al momento giusto. È qui che i fornitori specializzati hanno un vantaggio significativo.

Un pianificatore che pubblica in modo affidabile su Pinterest su larga scala richiede un'infrastruttura altamente disponibile e a bassa latenza, oltre a una gestione intelligente dei limiti di frequenza. I fornitori di livello industriale riportano spesso SLA nel 99,9% gamma e sotto-100ms tempi di risposta per garantire una pubblicazione prevedibile. Ad esempio, API unificate come Late servono oltre 2.000 sviluppatori e hanno fornito oltre 2,3 milioni post con 99,97% tempo di attività e sub-50 ms tempi di risposta medi.

Scegliere un'API unificata è, in definitiva, una mossa strategica. È una decisione per concentrarsi sul tuo prodotto principale anziché diventare un esperto involontario nel mondo in continua evoluzione delle API dei social media. Ti consente di offrire maggiore valore ai tuoi utenti, in modo più rapido e affidabile.

Ecco alcune delle domande più comuni che sorgono quando gli sviluppatori iniziano a lavorare con l'API di Pinterest. Approfondiamo le risposte in modo da poter evitare questi ostacoli frequenti.

Come si programmando i Video Pin?

Pianificare un video Pin non è così semplice come farlo con un'immagine Pin. Poiché Pinterest ha bisogno di tempo per elaborare il file video, si tratta di un processo in due fasi. Non puoi semplicemente inviare un URL e considerarla conclusa.

Prima di tutto, devi informare Pinterest che stai per inviare un video. Questa chiamata API iniziale registra il caricamento e ti restituisce un codice speciale. upload_url e alcuni upload_parameters. Con questi a disposizione, puoi quindi creare un multipart POST richiesta a quell'URL unico, inviando il file video effettivo.

Una volta completato, riceverai un media_idQuesto ID è quello che utilizzerai per creare il Pin. Invece del solito image_url sorgente, specificherai video_id nel tuo payload.

{
"board_id": "YOUR_BOARD_ID",
"media_source": {
"source_type": "video_id",
"media_id": "IL_TUO_ID_VIDEO_CARICATO"
},
"description": "Questo è un fantastico video Pin programmato tramite l'API!",
"publish_at": "2026-01-15T18:00:00Z"
}
Questo flusso asincrono garantisce che il video venga completamente elaborato e sia pronto per la pubblicazione esattamente secondo il programma.

Migliori Pratiche per Gestire Più Account Utente

Se stai creando uno strumento SaaS o una piattaforma per agenzie, dovrai gestire l'accesso all'API per molti utenti di Pinterest. La chiave fondamentale è una gestione dei token solida e sicura.

Ogni utente che collega il proprio account Pinterest tramite OAuth 2.0 avrà il proprio access_token and refresh_tokenIl tuo compito è archiviare questi dati in modo sicuro, crittografati a riposo e direttamente collegati all'ID di quell'utente nel tuo database.

Quando è il momento di pubblicare per loro, il tuo sistema dovrebbe:

  1. Recupera i token crittografati per quell'utente specifico.
  2. Decrittali giusto in tempo per la chiamata API.
  3. Utilizza il access_token nella tua richiesta.
  4. Se ricevi un 401 Non autorizzato errore, è tempo di utilizzare il loro refresh_token per ottenere un nuovo access_tokenAggiorna i token nel tuo database e riprova la richiesta.

Questo mantiene l'autenticazione di ogni utente completamente separata, evita perdite di dati e garantisce che la tua app possa continuare a pubblicare per loro senza interruzioni.

Qualunque cosa tu faccia, non cadere nella trappola di utilizzare un unico set di credenziali "master". L'API di Pinterest è costruita su permessi delegati dagli utenti. Ogni singola chiamata API deve essere autenticata dall'utente specifico che ti ha dato il consenso.

Ci sono limiti sulla programmazione dei pin in anticipo?

Questa è una delle principali ragioni per cui gli sviluppatori si rivolgono direttamente all'API. Se utilizzi il pianificatore di Pinterest sul loro sito web, di solito sei limitato, potendo programmare solo circa 30 giorni fuori.

Ma quando tu programma i pin di Pinterest tramite un'APIquella limitazione svanisce.

Puoi programmare contenuti mesi—o addirittura un anno o più—prima. Questo è un cambiamento radicale per la creazione di calendari editoriali a lungo termine, specialmente per campagne stagionali o contenuti evergreen che desideri impostare e dimenticare. pubblica_a il campo è il tuo alleato; accetta qualsiasi timestamp ISO 8601 valido nel futuro, offrendoti totale libertà.

Posso modificare un Pin programmato tramite l'API?

La risposta breve è no, non direttamente. Una volta inviato il request di creazione per programmare un Pin, l'API lo considera definitivo. Non puoi tornare indietro e modificare l'immagine, il link o la descrizione mentre è in attesa di essere pubblicato.

Se noti un errore o hai bisogno di apportare una modifica, il flusso di lavoro corretto è eliminare e ricreare.

  • Elimina il Pin programmato: Utilizza il pin_id hai ricevuto quando l'hai creato per la prima volta e invia un DELETE richiesta a /it/v5/pins/{pin_id}.
  • Crea un nuovo Pin: Crea un nuovo payload con tutte le informazioni corrette e un nuovo pubblica_a tempo.

Potrebbe sembrare un po' fastidioso, ma questo modello di "cancellare e ricreare" è di gran lunga più affidabile rispetto a un sistema di editing complesso. Garantisce che ciò che viene pubblicato sia esattamente ciò che avevi in mente.


Pronto a smettere di destreggiarti tra più API e iniziare a costruire più velocemente? Con Latepuoi accedere a dieci piattaforme social attraverso un'unica API unificata. Configurati in pochi minuti e concentrati sulla creazione di funzionalità, non sulla gestione delle integrazioni. Pianifica i tuoi pin su Pinterest e molto altro con la nostra potente API oggi stesso!.

Una API. 11+ piattaforme.

Integra i social in minuti, non settimane.

Progettato per sviluppatori. Apprezzato dalle agenzie. Fidato da 6.325 utenti.