--- title: "Tags e privacidade: Upload YouTube Video Through API" description: "Shorts ou vídeo longo: upload YouTube video through API com videoTitle, tags, privacyStatus, categoryId e playlistId em um POST /social-posts." url: "https://adaptlypost.com/pt/usages/upload-youtube-video-through-api" --- # Títulos, tags, privacidade e Shorts: upload YouTube video through API Um único POST autenticado permite upload YouTube video through API com um título, até 20 tags, um status de privacidade e o id de uma playlist existente anexados. Aqui o YouTube é só vídeo - sem posts de Comunidade, sem posts de imagem ou de texto -, então o payload é pequeno e as regras são rígidas. [Obtenha uma chave de API](https://adaptlypost.com/pt/signup) ![Um payload POST /social-posts com um objeto youtubeConfigs contendo videoTitle, tags, privacyStatus e playlistId](https://cdn.adaptlypost.com/public/adaptlypost_dashboard.png) ## Toda opção específica do YouTube fica em um objeto youtubeConfigs carrega postType, videoTitle, tags, categoryId, privacyStatus, playlistId e as flags de notify/embed/kids/license, e viaja na mesma requisição POST /social-posts que referencia o arquivo enviado. Gerir ### Publique em todas as suas plataformas de uma vez Compartilhe no Instagram, TikTok, YouTube, X e mais com um clique. Cada post se adapta automaticamente. [Saiba mais](https://adaptlypost.com/pt/features/post-multiple-social-media-accounts-once) Agendar ### Calendário visual de conteúdo O calendário do AdaptlyPost mostra cada rascunho, post agendado e post publicado por dia, para que seus horários de publicação continuem preenchidos. [Saiba mais](https://adaptlypost.com/pt/features/social-media-content-calendar) Mensurar ### Análise de redes sociais em um só lugar O AdaptlyPost acompanha visualizações, curtidas, compartilhamentos e engajamento de cada conta conectada em um único painel de análises. [Saiba mais](https://adaptlypost.com/pt/features/social-media-analytics) Integrar ### Acesso à API e skill OpenClaw Conecte via API ou deixe seu agente OpenClaw gerenciar publicações. Automatize redes sociais com comandos em linguagem natural. [Saiba mais](https://adaptlypost.com/pt/features/openclaw-integration) Gerar ### Gerador de imagens com IA para redes sociais Gere imagens impactantes em segundos. Descreva sua visão e deixe a IA dar vida a ela. [Saiba mais](https://adaptlypost.com/pt/features/ai-social-media-image-generator) Criar ### Gerador de legendas com IA para cada plataforma O copiloto de IA do AdaptlyPost escreve legendas, reescreve para cada plataforma e adiciona hashtags a partir de um único prompt. [Saiba mais](https://adaptlypost.com/pt/features/ai-caption-writer) Organizar ### Planejador de conteúdo para redes sociais O AdaptlyPost mantém rascunhos, posts agendados e conteúdo publicado em uma única fila, para você ver o que vai ao ar e quando. [Saiba mais](https://adaptlypost.com/pt/features/ai-social-media-scheduler) ## A Confiança de Criadores e Equipes Veja como criadores, profissionais de marketing, agências e pequenas empresas usam o AdaptlyPost para manter a consistência e economizar horas toda semana. 11 contas em 8 plataformas com quase zero atrito Atualmente administro 11 contas espalhadas por Facebook, Instagram, Threads, LinkedIn, Bluesky, YouTube, X e TikTok, todas conectadas e publicando diariamente. Facilidade de uso: 10/10\. A curva de aprendizado é praticamente inexistente. Agendar posts em várias plataformas leva minutos em vez das horas que eu levava fazendo na mão. Substituiu pelo menos duas outras assinaturas e não me arrependo de nada. [![jeremy8939](https://user-images.trustpilot.com/654e8b0e7995ec0012abfe16/73x73.png)jeremy8939](https://appsumo.com/products/adaptlypost/reviews/running-11-accounts-across-8-platforms-w-394974/) Simples, poderoso e com um apoio incrível É fácil de usar, e ligá-lo ao Claude permite-me organizar e distribuir vídeos e imagens mantendo-me fiel ao estilo da minha marca. O que se destaca mesmo é o apoio: disse ao Taras que precisava de duas funcionalidades novas, publicar posts de Instagram misturando imagens e vídeos, e carregar PDFs para o LinkedIn através do MCP, e ele teve ambas prontas em apenas 3 horas. Rápido, disponível e verdadeiramente incrível. [![destaca](https://www.gravatar.com/avatar/157e34bd35b2bf10070e62ec9211765f?s=100&d=404)destaca](https://appsumo.com/products/adaptlypost/reviews/simple-powerful-and-amazing-support-395516/) A minha experiência honesta a gerir as redes sociais com o AdaptlyPost e o Claude AI E depois a parte que ainda me parece um pouco louca: disse ao Claude para gerar as publicações completas, com imagens e grafismos, e agendar tudo através do AdaptlyPost. Fui ao meu calendário de conteúdos à espera de ter de acompanhar o processo. Já estava preenchido. 30 dias de publicações, textos e imagens, agendados e prontos. Tudo isto demorou cerca de 10 minutos. Antes perdia horas todas as semanas nisto. [![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/) Finalmente uma ferramenta que encaixa num fluxo de trabalho terminal-first (e um suporte de topo!) Já experimentei várias ferramentas de agendamento de redes sociais no passado e nenhuma encaixava bem no meu fluxo de trabalho. O Adaptly mudou isso por completo. [![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/) Um programador que responde e um link de ligação para clientes que resolve uma dor real das agências A minha funcionalidade preferida é o link de ligação partilhável. Geras um link para o cliente ligar as próprias contas sociais, sem precisar de acesso ao painel. Conseguir que clientes não técnicos me deem acesso às contas sempre foi um ponto de atrito, e isto elimina quase toda essa fricção. Envio um link, eles clicam e autorizam, e está feito. [![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/) Um agendador multiconta sólido, gerimos 3 marcas com ele diariamente Usamos o AdaptlyPost para agendar Instagram, Facebook, LinkedIn (e Stories) de três marcas. O que mais gosto é que não atrapalha assim que as publicações estão em fila. Agendamos imagens, carrosséis e Reels/Stories em lotes, revemos o calendário e deixamos publicar. [![Dacstyle](https://www.gravatar.com/avatar/723b8e02844d3f0010682cab9e1b0144?s=100&d=404)Dacstyle](https://appsumo.com/products/adaptlypost/reviews/solid-multi-account-scheduler-we-run-3-395262/) ## Do terminal vazio ao upload publicado Passo 1 ### Crie uma chave e consulte o canal As chaves são emitidas no painel em Settings > API Tokens e começam com adaptly\_. Envie-as como \`Authorization: Bearer \` contra https://post.adaptlypost.com/post/api/v1\. O canal em si é conectado por OAuth no painel - não existe endpoint que conecte, desconecte ou verifique a saúde de um canal do YouTube - e então \`GET /social-accounts\` retorna seu id, platform e displayName para você referenciar no post. Uma chamada mira um canal do YouTube: um segundo canal é uma segunda chamada, e enviar duas contas do YouTube em um payload é rejeitado com um 400. Passo 2 ### Envie o arquivo e faça POST /social-posts com youtubeConfigs Somente video/mp4 e video/quicktime são aceitos, e \`POST /upload-urls\` rejeita qualquer outro mime type de imediato, então peça as URLs pré-assinadas lá (1-20 arquivos, válidas por uma hora), faça PUT do arquivo e crie o post com \`text\`, \`platforms: \["YOUTUBE"\]\`, \`timezone\` (IANA, ex.: "Europe/Berlin"), \`contentType: "VIDEO"\` e um objeto \`youtubeConfigs\`. A lista de content types suportados do YouTube é VIDEO e o máximo de imagens por post é 0, então um post IMAGE ou TEXT que inclua o YouTube nunca chega ao canal. O corpo da requisição é validado de forma síncrona: \`videoTitle\` acima de 100 caracteres, mais de 20 \`tags\`, um campo obrigatório ausente ou um content type não suportado voltam como um 400 na própria chamada de criação, sem registro de post gravado e sem nada para redisparar. \`postType: "SHORTS"\` exige um arquivo 9:16 de 60 segundos ou menos, então confira proporção e duração antes de chamar. Adicione \`scheduledAt\` para agendar em vez de publicar imediatamente. Passo 3 ### Leia platformPostId, ou corrija e redispare \`GET /social-posts/:id/results\` retorna a entrada do YouTube com \`status\`, \`publishedAt\`, \`errorMessage\` e \`platformPostId\` - o id bruto do vídeo no YouTube. Nenhuma URL de exibição é devolvida, então monte o link você mesmo a partir desse id. Esse endpoint reporta o que o YouTube fez depois de aceitarmos e despacharmos o upload, não se o payload estava bem formado - payloads malformados nunca chegam até aqui, porque falharam com um 400 na criação. O que aparece em \`errorMessage\` é do lado do canal: um \`playlistId\` que não existe no canal conectado, uma concessão de OAuth que o dono do canal revogou ou um upload que o YouTube recusou ou limitou durante seu próprio processamento. Corrija a causa e chame \`POST /social-posts/:id/retry\` com os \`platformIds\` que falharam, em vez de recriar o post. Não existe sandbox em lugar nenhum da API, então o mais próximo de um teste a seco é publicar com \`privacyStatus: "PRIVATE"\` e mudar isso depois no YouTube Studio. ## Preços simples e transparentes Escolha o plano perfeito para você \-17% ### Creator Perfeito para indivíduos e empreendedores $19 /mês [Comece seu teste grátis de 7 dias](https://adaptlypost.com/pt/signup) * 30 contas sociais conectadas * Posts agendados ilimitados * Colaboração em equipe * 1 espaço de trabalho * 150 créditos de IA/mês * Legendas IA * Estúdio de imagens IA * API/MCP/CLI * Posts de imagem, vídeo e carrossel * Direct Connector * Plugin direto * Extensões de navegador Funciona com Mais popular ### Pro Para profissionais e equipes em crescimento $39 /mês [Comece seu teste grátis de 7 dias](https://adaptlypost.com/pt/signup) * 60 contas sociais conectadas * Posts agendados ilimitados * 3 membros de equipe * 3 espaços de trabalho * 400 créditos de IA/mês * Legendas IA * Estúdio de imagens IA * API/MCP/CLI * Posts de imagem, vídeo e carrossel * Direct Connector * Plugin direto * Extensões de navegador Funciona com ### Enterprise Para agências e empresas prontas para escalar $89 /mês [Comece seu teste grátis de 7 dias](https://adaptlypost.com/pt/signup) * 100 contas sociais conectadas * Posts agendados ilimitados * 10 membros de equipe * 10 espaços de trabalho * 1000 créditos de IA/mês * Legendas IA * Estúdio de imagens IA * API/MCP/CLI * Posts de imagem, vídeo e carrossel * Direct Connector * Plugin direto * Extensões de navegador Funciona com ### Personalizado Limites sob medida, white-label e suporte prioritário Personalizado * Contas sociais ilimitadas * Posts agendados ilimitados * Membros de equipe ilimitados * Espaços de trabalho ilimitados * Créditos de IA ilimitados * Legendas IA * Estúdio de imagens IA * API/MCP/CLI * Posts de imagem, vídeo e carrossel * Direct Connector * Plugin direto * Extensões de navegador Funciona com Todos os planos incluem teste gratuito de 7 dias Quer ver a comparação completa de recursos? [Ver página de preços](https://adaptlypost.com/pt/pricing) ## O que você realmente pode definir em um upload do YouTube ### Uploads longos com metadados anexados \`postType: "VIDEO"\` publica um upload padrão. \`videoTitle\` define o título com teto de 100 caracteres, \`tags\` aceita até 20 strings, \`categoryId\` recebe o id numérico de categoria do YouTube, e o \`text\` do post viaja com o vídeo como texto do corpo. Nada além desse objeto é configurável: não existem campos de miniatura, capítulos, tela final, legendas ou estreia nesta API. ### Shorts no mesmo endpoint Mude \`postType\` para \`"SHORTS"\` para subir YouTube Shorts pela API - mesmo endpoint, mesmo youtubeConfigs, mesmo pipeline de upload-urls. A restrição decisiva é a mídia, não a flag: um Short exige proporção 9:16 e duração de 60 segundos ou menos, então valide dimensões e duração antes de chamar, não depois. ### Privacidade, notificações e a flag de público \`privacyStatus\` aceita PUBLIC, UNLISTED ou PRIVATE. \`notifySubscribers\` decide se os inscritos do canal são avisados, \`allowEmbedding\` define a permissão de incorporação, \`madeForKids\` carrega a designação de público e \`license\` define a licença do vídeo. Todos são por post, então uma fila de uploads de arquivo pode sair privada e silenciosa enquanto um vídeo de lançamento sai público e notifica. ### Adicionar o upload a uma playlist existente Defina \`playlistId\` em youtubeConfigs e o upload finalizado é arquivado nessa playlist. Ela precisa já existir - a API consegue adicionar a uma playlist, mas não criar, renomear, reordenar nem listar uma -, então copie o id do YouTube Studio (o valor de \`list=\` na URL da playlist) e guarde-o na sua própria config. Se o id estiver errado, isso aparece na entrada do YouTube retornada por \`/results\`. ## Configure seu primeiro upload no YouTube Crie uma chave em Settings > API Tokens, importe GET /openapi.json no seu cliente HTTP, no Make ou no n8n, e o primeiro upload fica a um POST de distância. Teste com privacyStatus PRIVATE antes de ir a público. [Obtenha uma chave de API](https://adaptlypost.com/pt/signup)