5000 bytes, não caracteres: o limite de caracteres da descrição do YouTube

Qual é o limite de caracteres da descrição do YouTube?

A YouTube Data API do Google define o limite de caracteres da descrição do YouTube em 5000 bytes, não em 5000 caracteres, e no mesmo objeto limita o título do vídeo a 100 caracteres e a lista completa de tags a 500 caracteres. A página de referência do recurso videos diz isso diretamente: "The video's description. The property value has a maximum length of 5000 bytes and may contain all valid UTF-8 characters except < and >." Dois campos no mesmo objeto, duas unidades diferentes.

Essa única palavra muda a resposta para quem escreve em um alfabeto não latino ou usa emojis. Um byte mede armazenamento, um caractere mede texto. O UTF-8 codifica uma letra ASCII em um byte e um caractere japonês em três, então os dois números se separam no momento em que sua descrição deixa de ser inglês simples.

Campo	Limite documentado	Unidade	Propriedade da API
Título do vídeo	100	caracteres	snippet.title
Descrição do vídeo	5000	bytes	snippet.description
Todas as tags somadas	500	caracteres	snippet.tags[]

Fonte: a referência da YouTube Data API v3 para o recurso videos, consultada em 10 de setembro de 2026.

Por que o YouTube conta a descrição em bytes?

O YouTube conta a descrição em bytes porque o campo é validado contra sua codificação UTF-8 armazenada, não contra uma contagem de caracteres renderizados. O UTF-8 tem largura variável: gasta um byte na faixa ASCII original, dois no latim acentuado, no cirílico, no grego, no hebraico e no árabe, três no chinês, japonês, coreano e devanágari, e quatro nos planos de emoji. A API mede o tamanho da string codificada. Seu editor de texto mede outra coisa.

É a mesma armadilha que o AT Protocol documenta para os offsets byteStart e byteEnd dos facets do Bluesky, e a mesma em que a Meta cai quando o Threads conta um emoji pelo tamanho em bytes UTF-8. Conte os bytes codificados antes de enviar, não os caracteres que seu editor mostra.

Quantos caracteres cabem de verdade em uma descrição?

Você só tem 5000 caracteres se todos os caracteres da descrição forem ASCII. Divida o orçamento de 5000 bytes pelo custo por caractere do seu alfabeto para chegar ao teto real.

bytes = (1 x ascii_chars) + (2 x two_byte_chars) + (3 x three_byte_chars) + (4 x four_byte_chars)

Conteúdo	Exemplo	Bytes por caractere	Caracteres em 5000 bytes
Letras ASCII, dígitos, espaços, pontuação	a	1	5000
Latim acentuado, cirílico, grego, árabe, hebraico	д	2	2500
Chinês, japonês, coreano, devanágari	動	3	1666
Emojis dos planos suplementares	🔥	4	1250

Emojis compostos custam mais de um ponto de código. Um joinha com modificador de tom de pele são dois pontos de código de quatro bytes cada, então 👍🏽 custa 8 bytes. Um emoji de família com quatro pessoas são quatro emojis unidos por três zero width joiners (o caractere invisível que junta emojis), e cada joiner é um caractere de três bytes, então 👨‍👩‍👧‍👦 custa 25 bytes por um único glifo que o leitor vê como uma só imagem.

Uma descrição com menos de 5000 caracteres ainda pode ser rejeitada?

Sim, e a conta é esta. Pegue um canal japonês de culinária cuja descrição tem 1.200 caracteres japoneses de notas de receita, 1.100 caracteres ASCII de timestamps e URLs, e 40 emojis.

(1200 x 3) + (1100 x 1) + (40 x 4) = 3600 + 1100 + 160 = 4860 bytes

Essa descrição tem 2.340 caracteres e 4.860 bytes, então o upload passa. Adicione mais 47 caracteres japoneses e ela vira 2.387 caracteres e 5.001 bytes, um byte acima do teto. A API rejeita uma descrição de 2.387 caracteres, menos da metade do número que disseram ao criador para usar como meta. A rejeição chega como invalidDescription com HTTP 400 e a mensagem "The request metadata specifies an invalid video description," que não cita comprimento nem unidade.

Uma descrição, um byte a mais

2.340 caracteres, 4.860 bytes

• 1.200 caracteres japoneses
• 1.100 caracteres ASCII
• 40 emojis
• É enviada sem problemas

2.387 caracteres, 5.001 bytes

• Mais 47 caracteres japoneses
• Um byte acima do limite de 5000 bytes
• Rejeitada com invalidDescription, HTTP 400

A Central de Ajuda do YouTube concorda com a API?

Não. O artigo da Central de Ajuda do YouTube sobre envio de vídeos diz "Video descriptions have a character limit of 5,000 characters and cannot include invalid characters," o que usa a unidade errada para o mesmo campo que a API documenta em bytes. O número do título bate nas duas páginas em 100 caracteres, então a divergência se limita à descrição.

Trate a referência da API como autoridade, porque ela descreve o validador que aceita ou rejeita seu upload. Em alfabeto latino sem emojis, os dois documentos dão a mesma resposta prática e a discrepância nunca aparece. Em japonês, hindi, árabe ou russo, o número da Central de Ajuda superestima seu orçamento de duas a três vezes.

Onde o YouTube corta a descrição na página de exibição?

O YouTube não publica o ponto em que a página de exibição corta uma descrição. O número de 5000 bytes é um limite de armazenamento aplicado no upload, e a prévia recolhida acima do controle "...more" é um comportamento de layout separado que o YouTube não documenta em lugar nenhum. Nem a referência da Data API nem o artigo da Central de Ajuda sobre como adicionar uma descrição informam uma contagem de caracteres, de bytes ou de linhas para a visualização recolhida.

O mecanismo explica por que não existe um número fixo. A página de exibição renderiza a descrição dentro de um contêiner cuja altura é definida pelo layout ao redor, e a quantidade de texto visível antes de o leitor expandir muda com a largura da viewport, o tamanho da fonte e as linhas de metadados acima dela. Uma contagem que vale num desktop de 27 polegadas não vale num celular na vertical. Circulam números em artigos de SEO como se o Google os tivesse publicado. O Google não publicou.

A solução não depende do ponto de corte: coloque o link, a chamada para ação e a frase que precisa ser lida nas primeiras linhas, e deixe o resto se estender. As escolhas de formatação nesse bloco inicial também contam, e as regras de formatação de texto do YouTube definem o que é renderizado e o que aparece como caracteres literais.

O que conta para o limite de 500 caracteres das tags?

O limite de 500 caracteres vale para a lista de tags como um todo, não para cada tag. A API documenta isso na propriedade de array: "A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters." Vinte tags com média de 25 caracteres esgotam o orçamento, e uma única frase de cauda longa com 60 caracteres ocupa sozinha um oitavo dele.

O YouTube não documenta se os separadores entre tags contam para os 500, então a suposição segura é que contam e a meta segura fica alguns caracteres abaixo do teto. Repare de novo na unidade: as tags são contadas em caracteres enquanto a descrição ao lado é contada em bytes, então um conjunto de tags não latinas se comporta de forma diferente de uma descrição não latina. Outras redes definem seus limites de outro jeito, desde o limite da legenda do TikTok medido em runas UTF-16 até o limite de caracteres do texto alternativo na API do Instagram.

Onde o adaptlypost entra

O adaptlypost publica no YouTube pela mesma Data API a que esses limites pertencem, então o teto de 5000 bytes vale ali exatamente como vale para um upload direto. O agendador de vídeos do YouTube coloca na fila os uploads com títulos, descrições e tags anexados, e o redator de legendas com IA escreve o texto da descrição que você depois confere contra o orçamento de bytes. Nenhuma ferramenta de agendamento aumenta o teto de uma plataforma; os limites acima são do Google e valem qualquer que seja o cliente que envia a requisição.

Perguntas frequentes

O limite de caracteres da descrição do YouTube é de 5000 caracteres ou de 5000 bytes?

A YouTube Data API documenta 5000 bytes na propriedade snippet.description do recurso videos. A Central de Ajuda do YouTube informa 5.000 caracteres para o mesmo campo. A referência da API é a que corresponde ao validador, então trate o limite como 5000 bytes.

Quantos caracteres japoneses ou chineses cabem em uma descrição do YouTube?

O UTF-8 codifica a maioria dos caracteres chineses, japoneses e coreanos em três bytes, o que coloca o teto em 1.666 caracteres de texto CJK puro. Conteúdo misto fica entre esse número e 5.000, dependendo de quanto ASCII você inclui. Timestamps, URLs e hashtags latinas custam um byte por caractere e esticam o orçamento.

Um emoji conta como um caractere em uma descrição do YouTube?

Não. Emojis dos planos suplementares custam quatro bytes cada, um modificador de tom de pele soma mais quatro e cada zero width joiner de um emoji composto soma três. Um emoji de família com quatro pessoas custa 25 bytes do orçamento de 5000 bytes e ocupa um único glifo na tela.

Qual é o limite de caracteres do título de um vídeo do YouTube?

A API limita snippet.title a 100 caracteres e expressa esse limite em caracteres, não em bytes. A mesma propriedade proíbe os caracteres < e >. A Central de Ajuda do YouTube dá o mesmo número de 100, então esse campo não tem divergência de unidade.

Quantas tags um vídeo do YouTube pode ter?

O YouTube limita o comprimento total da lista de tags a 500 caracteres e não documenta limite para o número de tags. Vinte tags de 25 caracteres enchem o orçamento, e quarenta tags de 12 caracteres também. O YouTube não documenta se os separadores contam para os 500.

Onde o YouTube corta a descrição antes do "...more"?

O YouTube não publica nenhum ponto de corte. A altura recolhida é um resultado do layout que muda com a largura da viewport, o tamanho da fonte e as linhas de metadados acima da descrição, então a parte visível difere entre um navegador de desktop e um celular. Escreva as linhas importantes primeiro em vez de mirar numa contagem de caracteres que ninguém no Google confirmou.

Qual mensagem de erro aparece quando uma descrição do YouTube excede o limite de bytes?

A API rejeita o envio com o erro invalidDescription e o status HTTP 400. A mensagem diz "The request metadata specifies an invalid video description" e não menciona o tamanho nem a unidade que falhou. Quem for depurar a rejeição já precisa saber que o campo é medido em bytes para achar a causa.

Os separadores entre as tags do YouTube contam para o limite de 500 caracteres?

O YouTube não documenta se as vírgulas ou espaços entre as tags em snippet.tags[] contam para o limite de 500 caracteres. A suposição segura é que contam, então a meta segura é ficar alguns caracteres abaixo do teto em vez de exatamente nele. Vinte tags com média de 25 caracteres já esgotam o orçamento sem somar nenhum separador.

O redator de legendas com IA do adaptlypost verifica automaticamente o limite de bytes de uma descrição?

Não. O adaptlypost limita uma descrição do YouTube a 5000 caracteres no editor, mas a YouTube Data API aplica o teto em bytes, então um rascunho do redator de legendas com IA pode respeitar o limite de caracteres e mesmo assim ser recusado. Texto com acentos, em cirílico ou em escrita CJK esgota os bytes antes dos caracteres. Conte os bytes antes de agendar uma descrição longa que não esteja em inglês, porque nenhuma ferramenta de agendamento eleva o teto definido pelo Google.

Quantos caracteres cabem em uma descrição do YouTube escrita em árabe, hebraico ou russo?

Esses alfabetos caem na faixa de dois bytes do UTF-8, junto com o latim acentuado e o grego, o que fixa o teto prático em 2500 caracteres em vez de 5000. Isso é metade do orçamento que o número da Central de Ajuda sugere. Misturar texto ASCII como URLs ou marcas de tempo estica o total de novo, porque cada um desses caracteres custa um byte em vez de dois.