--- title: "Titoli, tag, privacy: carica video su YouTube via API" description: "Shorts o video lunghi: carica video su YouTube via API con videoTitle, tags, privacyStatus, categoryId e playlistId in una sola chiamata POST /social-posts." url: "https://adaptlypost.com/it/usages/upload-youtube-video-through-api" --- # Titoli, tag, privacy e Shorts: carica video su YouTube tramite API Un solo POST autenticato ti permette di caricare video su YouTube tramite API con titolo, fino a 20 tag, uno stato della privacy e l'id di una playlist esistente. Qui YouTube è solo video: niente post della community, niente post con immagini o di solo testo, quindi il payload è piccolo e le regole sono rigide. [Ottieni una chiave API](https://adaptlypost.com/it/signup) ![Un payload POST /social-posts con un oggetto youtubeConfigs che contiene videoTitle, tags, privacyStatus e playlistId](https://cdn.adaptlypost.com/public/adaptlypost_dashboard.png) ## Tutte le opzioni specifiche di YouTube in un unico oggetto youtubeConfigs contiene postType, videoTitle, tags, categoryId, privacyStatus, playlistId e i flag notify/embed/kids/license, e viaggia nella stessa richiesta POST /social-posts che fa riferimento al file caricato. Gestisci ### Pubblica su tutte le piattaforme in un colpo solo Condividi su Instagram, TikTok, YouTube, X e altre piattaforme con un clic. Ogni post si adatta da solo alla piattaforma. [Scopri di più](https://adaptlypost.com/it/features/post-multiple-social-media-accounts-once) Programma ### Calendario editoriale visivo Il calendario di AdaptlyPost mostra giorno per giorno ogni bozza, post programmato e post pubblicato, così non lasci buchi nel piano di pubblicazione. [Scopri di più](https://adaptlypost.com/it/features/social-media-content-calendar) Misura ### Statistiche dei social in un unico posto AdaptlyPost tiene traccia di visualizzazioni, like, condivisioni ed engagement di ogni account collegato in un'unica dashboard di analytics. [Scopri di più](https://adaptlypost.com/it/features/social-media-analytics) Integra ### Accesso API e skill OpenClaw Collegati tramite API o lascia che il tuo agente AI OpenClaw gestisca i post per te. Automatizza i social con comandi in linguaggio naturale. [Scopri di più](https://adaptlypost.com/it/features/openclaw-integration) Genera ### Generatore di immagini AI per i social Genera in pochi secondi immagini che fermano lo scroll. Descrivi la tua idea e lascia che l'AI le dia forma. [Scopri di più](https://adaptlypost.com/it/features/ai-social-media-image-generator) Crea ### Generatore di didascalie AI per ogni piattaforma Il copilota AI di AdaptlyPost scrive le didascalie, le riscrive per ogni piattaforma e aggiunge gli hashtag partendo da un solo prompt. [Scopri di più](https://adaptlypost.com/it/features/ai-caption-writer) Organizza ### Planner dei contenuti social AdaptlyPost tiene bozze, post programmati e contenuti pubblicati in un'unica coda, così vedi cosa va online e quando. [Scopri di più](https://adaptlypost.com/it/features/ai-social-media-scheduler) Automatizza ### Dai feed RSS ai social Collega il feed RSS del tuo blog e AdaptlyPost pubblica ogni nuovo articolo sugli account che scegli, come bozza, programmato o subito. [Scopri di più](https://adaptlypost.com/it/features/rss-to-social-media) ## Scelto da creator e team Scopri come creator, marketer, agenzie e piccole imprese usano AdaptlyPost per pubblicare con costanza e risparmiare ore ogni settimana. Gestisco 11 account su 8 piattaforme quasi senza attriti Al momento gestisco 11 account tra Facebook, Instagram, Threads, LinkedIn, Bluesky, YouTube, X e TikTok, tutti collegati e con pubblicazioni ogni giorno. Facilità d'uso: 10/10\. La curva di apprendimento praticamente non esiste. Programmare i post su più piattaforme richiede minuti invece delle ore che ci mettevo facendolo a mano. Ha sostituito almeno altri due abbonamenti e non ho alcun rimpianto. [![jeremy8939](https://user-images.trustpilot.com/654e8b0e7995ec0012abfe16/73x73.png)jeremy8939](https://appsumo.com/products/adaptlypost/reviews/running-11-accounts-across-8-platforms-w-394974/) Semplice, potente e con un'assistenza straordinaria È facile da usare, e collegarlo a Claude mi permette di organizzare e distribuire video e immagini restando fedele allo stile del mio brand. Ma a fare davvero la differenza è l'assistenza: ho detto a Taras che mi servivano due nuove funzioni, pubblicare post Instagram che mescolano immagini e video e caricare PDF su LinkedIn tramite MCP, e lui le ha rese disponibili entrambe in appena 3 ore. Veloce, reattivo e davvero straordinario. [![destaca](https://www.gravatar.com/avatar/157e34bd35b2bf10070e62ec9211765f?s=100&d=404)destaca](https://appsumo.com/products/adaptlypost/reviews/simple-powerful-and-amazing-support-395516/) La mia esperienza sincera nel gestire i social con AdaptlyPost + Claude AI Poi la parte che mi sembra ancora un po' assurda: ho chiesto a Claude di generare i post completi, immagini e grafiche comprese, e di programmare tutto tramite AdaptlyPost. Sono andato sul calendario editoriale pensando di dover seguire il processo passo passo. Era già pieno. 30 giorni di post, testi e immagini, programmati e pronti. Il tutto in circa 10 minuti. Prima ci perdevo ore ogni settimana. [![basantkumar405](https://www.gravatar.com/avatar/59dad61d05ca61aa6547cf9c019dcbe6?s=100&d=404)basantkumar405](https://appsumo.com/products/adaptlypost/reviews/my-honest-experience-running-my-social-m-395833/) Il mio agente AI ti ringrazia Taras Shynkarenko è il migliore! Gli ho chiesto di aggiungere il collegamento a Telegram e l'ha fatto in pochi giorni. È il servizio più incredibile che puoi usare, soprattutto con gli agenti AI. A proposito, il mio agente AI ti ringrazia :) per aver creato questo servizio fantastico e facile da usare. [![iTarek](https://www.gravatar.com/avatar/c270c90b0088fa3c432180c761f5e837?s=100&d=404)iTarek](https://appsumo.com/products/adaptlypost/reviews/my-ai-agent-thanks-you-396084/) Sviluppatore reattivo e un link di collegamento comodo per i clienti che risolve un vero problema delle agenzie La mia funzione preferita è lo Shareable Connect Link. Puoi generare un link con cui un cliente collega i propri account social, senza bisogno di accedere alla dashboard. Farmi dare l'accesso agli account da clienti poco tecnici è sempre stato un problema, e questo elimina gran parte delle difficoltà. Mando un link, loro cliccano e autorizzano, e ho finito. [![automatexyz](https://appsumo2-cdn.appsumo.com/media/users/avatars/AutomateXYZWebDesignLogo.JPG?width=150)automatexyz](https://appsumo.com/products/adaptlypost/reviews/responsive-developer-and-a-client-friend-395621/) Finalmente uno strumento adatto a un flusso di lavoro basato sul terminale (e un'assistenza di prim'ordine!) In passato ho provato diversi strumenti per programmare i post sui social, e nessuno si adattava davvero al mio modo di lavorare. Adaptly ha cambiato completamente le cose. [![mayank09](https://appsumo2-cdn.appsumo.com/media/users/avatars/Screenshot_2026-09-23_at_10.23.26PM.png?width=150)mayank09](https://appsumo.com/products/adaptlypost/reviews/finally-a-tool-that-fits-a-terminal-fir-395213/) ## Dal terminale vuoto al video pubblicato Passo 1 ### Crea una chiave, poi trova il canale Le chiavi si generano nella dashboard in Gestione > API e agenti AI e iniziano con adaptly\_. Inviale come \`Authorization: Bearer \` verso https://post.adaptlypost.com/post/api/v1\. Il canale si collega tramite OAuth nella dashboard (non esiste un endpoint che collega, scollega o verifica lo stato di un canale YouTube), poi \`GET /social-accounts\` restituisce id, platform e displayName da indicare nel post. Una chiamata riguarda un solo canale YouTube: un secondo canale richiede una seconda chiamata, e due account YouTube nello stesso payload vengono rifiutati con un 400. Passo 2 ### Carica il file, poi POST /social-posts con youtubeConfigs Sono accettati solo video/mp4 e video/quicktime, e \`POST /upload-urls\` rifiuta subito qualsiasi altro tipo MIME, quindi richiedi lì gli URL prefirmati (1-20 file, validi un'ora), carica il file con PUT e crea il post con \`text\`, \`platforms: \["YOUTUBE"\]\`, \`timezone\` (IANA, ad es. "Europe/Berlin"), \`contentType: "VIDEO"\` e un oggetto \`youtubeConfigs\`. L'unico tipo di contenuto supportato da YouTube è VIDEO e il numero massimo di immagini per post è 0, quindi un post IMAGE o TEXT che include YouTube non arriva mai al canale. Il corpo della richiesta viene validato in modo sincrono: un \`videoTitle\` oltre i 100 caratteri, più di 20 \`tags\`, un campo obbligatorio mancante o un tipo di contenuto non supportato restituiscono un 400 sulla chiamata di creazione stessa, senza alcun record del post e nulla da riprovare. \`postType: "SHORTS"\` richiede un file in 9:16 di 60 secondi o meno, quindi controlla proporzioni e durata prima della chiamata. Aggiungi \`scheduledAt\` per programmare invece di pubblicare subito. Passo 3 ### Leggi platformPostId, oppure correggi e riprova \`GET /social-posts/:id/results\` restituisce la voce di YouTube con \`status\`, \`publishedAt\`, \`errorMessage\` e \`platformPostId\`, cioè l'id grezzo del video YouTube. Non viene mai restituito un URL di visualizzazione, quindi costruisci tu il link a partire da quell'id. Questo endpoint riporta ciò che ha fatto YouTube dopo che abbiamo accettato e inviato il caricamento, non se il payload era corretto: i payload malformati non arrivano mai fin qui, perché sono falliti con un 400 alla creazione. In \`errorMessage\` compaiono problemi lato canale: un \`playlistId\` che non esiste sul canale collegato, un'autorizzazione OAuth revocata dal proprietario del canale, oppure un caricamento che YouTube ha rifiutato o limitato durante la sua elaborazione. Risolvi la causa e chiama \`POST /social-posts/:id/retry\` con i \`platformIds\` falliti invece di ricreare il post. Nell'API non esiste una sandbox, quindi la cosa più vicina a una prova a secco è pubblicare con \`privacyStatus: "PRIVATE"\` e cambiarlo poi in YouTube Studio. ## Prezzi semplici e trasparenti Scegli il piano più adatto alle tue esigenze \-17% ### Creator Ideale per singoli e professionisti in proprio $19 /mese [Inizia la prova gratuita di 7 giorni](https://adaptlypost.com/it/signup) * 30 account social collegati * Post programmati illimitati * Collaborazione in team * 1 workspace * 150 crediti AI/mese * Didascalie AI * AI Image Studio * API/MCP/CLI * Post con immagini, video e caroselli * Pubblicazione automatica da feed RSS * Connettore diretto * Plugin diretto * Integrazione Zapier * Estensioni del browser Funziona con Il più scelto ### Pro Per professionisti e team in crescita $39 /mese [Inizia la prova gratuita di 7 giorni](https://adaptlypost.com/it/signup) * 60 account social collegati * Post programmati illimitati * 3 membri del team * 3 workspace * 400 crediti AI/mese * Didascalie AI * AI Image Studio * API/MCP/CLI * Post con immagini, video e caroselli * Pubblicazione automatica da feed RSS * Connettore diretto * Plugin diretto * Integrazione Zapier * Estensioni del browser Funziona con ### Enterprise Per agenzie e aziende pronte a crescere $89 /mese [Inizia la prova gratuita di 7 giorni](https://adaptlypost.com/it/signup) * 100 account social collegati * Post programmati illimitati * 10 membri del team * 10 workspace * 1000 crediti AI/mese * Didascalie AI * AI Image Studio * API/MCP/CLI * Post con immagini, video e caroselli * Pubblicazione automatica da feed RSS * Connettore diretto * Plugin diretto * Integrazione Zapier * Estensioni del browser Funziona con ### Custom Limiti personalizzati, white label e supporto prioritario Personalizzato * Account social illimitati * Post programmati illimitati * Membri del team illimitati * Workspace illimitati * Crediti AI illimitati * Didascalie AI * AI Image Studio * API/MCP/CLI * Post con immagini, video e caroselli * Pubblicazione automatica da feed RSS * Connettore diretto * Plugin diretto * Integrazione Zapier * Estensioni del browser Funziona con Tutti i piani includono una prova gratuita di 7 giorni Vuoi vedere il confronto completo delle funzioni? [Vai alla pagina dei prezzi](https://adaptlypost.com/it/pricing) ## Cosa puoi impostare davvero su un caricamento YouTube ### Video lunghi con metadati \`postType: "VIDEO"\` pubblica un caricamento standard. \`videoTitle\` imposta il titolo con un limite di 100 caratteri, \`tags\` accetta fino a 20 stringhe, \`categoryId\` accetta l'id numerico della categoria YouTube, e il \`text\` del post accompagna il video come descrizione. Una miniatura personalizzata va in \`thumbnailUrl\`, oppure in una voce YouTube di \`platformThumbnails\`. In questa API non ci sono campi per capitoli, schermate finali, sottotitoli o premiere. ### Shorts sullo stesso endpoint Cambia \`postType\` in \`"SHORTS"\` per caricare YouTube Shorts tramite API: stesso endpoint, stesso youtubeConfigs, stessa pipeline upload-urls. Il vincolo decisivo è il media, non il flag: uno Short richiede proporzioni 9:16 e una durata di 60 secondi o meno, quindi verifica dimensioni e durata prima della chiamata, non dopo. ### Privacy, notifiche e indicazione del pubblico \`privacyStatus\` accetta PUBLIC, UNLISTED o PRIVATE. \`notifySubscribers\` decide se gli iscritti al canale ricevono una notifica, \`allowEmbedding\` imposta il permesso di incorporamento, \`madeForKids\` indica il pubblico di destinazione e \`license\` imposta la licenza del video. Sono tutti per singolo post, quindi un arretrato di video d'archivio può uscire privato e senza notifiche mentre un video di lancio esce pubblico e avvisa gli iscritti. ### Aggiungere il video a una playlist esistente Imposta \`playlistId\` in youtubeConfigs e il video caricato viene inserito in quella playlist. La playlist deve già esistere (l'API può aggiungere video a una playlist ma non può crearla, rinominarla, riordinarla o elencarle), quindi copia l'id da YouTube Studio (il valore \`list=\` nell'URL della playlist) e salvalo nella tua configurazione. Se l'id è sbagliato, lo vedi nella voce YouTube restituita da \`/results\`. ## Configura il tuo primo caricamento su YouTube Crea una chiave in Gestione > API e agenti AI, importa GET /openapi.json nel tuo client HTTP, in Make o in n8n, e il primo caricamento è a un POST di distanza. Fai una prova con privacyStatus PRIVATE prima di renderlo pubblico. [Ottieni una chiave API](https://adaptlypost.com/it/signup)