Verificador de incorporação do YouTube

Introdução

O Verificador de incorporação do YouTube da Toollect responde a uma pergunta que surge sempre que alguém adiciona vídeo a um site: este vídeo vai realmente tocar aqui, na minha página? Cole um link e a ferramenta verifica o vídeo contra duas superfícies públicas e sem chave do YouTube – o endpoint oEmbed e o player incorporado – e então diz se o vídeo é incorporável, reproduzível, ausente ou restrito. Sem conta, sem chave de API e sem upload.

A armadilha que ele elimina é conhecida. Você copia um código de incorporação, coloca na sua página e descobre mais tarde que o vídeo mostra um player cinza, um aviso de "Vídeo indisponível" ou uma mensagem para "Assistir no YouTube" porque o proprietário desativou a incorporação. Quando a incorporação está no ar, isso já virou uma pergunta de suporte. Verificar antes transforma a mesma tarefa em um passo de dois segundos.

A verificação roda inteiramente no seu navegador. A URL é analisada localmente, o status de incorporação é lido do endpoint oEmbed público do YouTube e uma incorporação ao vivo carrega na página, pausada no primeiro quadro – nunca reproduzida automaticamente, nunca silenciada para você. Nada é enviado, armazenado ou rastreado. O resultado aparece ao lado do título, do canal e da duração do vídeo, que a própria incorporação retorna – sem página separada, sem scraper, sem serviço de terceiros.

Como funciona

A ferramenta divide a pergunta "isso pode ser incorporado e reproduzido?" em três verificações independentes. Cada uma usa uma superfície pública e sem chave do YouTube, e as três rodam localmente no seu navegador.

1. Extração do ID do vídeo – a URL é analisada com o mesmo padrão que o próprio YouTube usa, reconhecendo links watch, youtu.be, Shorts, embed e live, além de um ID avulso de 11 caracteres.
2. Sonda de incorporação – a ferramenta consulta o endpoint oEmbed do YouTube para o vídeo. Um vídeo incorporável retorna um pequeno objeto JSON; um vídeo cujo proprietário proíbe a incorporação retorna um erro. É o mesmo endpoint que os serviços usam para gerar cards automaticamente.
3. Verificação do player – a ferramenta carrega o player incorporado, pausado no primeiro quadro, e escuta seu status. Se o vídeo foi removido ou restrito, o player dispara um código de erro; se carrega limpo, o título, o canal e a duração voltam do próprio player, e apertar o play confirma a reprodução ao vivo no mesmo quadro.

Nada disso exige a API Data oficial do YouTube. O JavaScript do player carrega sob demanda, não consome cota e roda inteiramente no seu navegador – seu link colado nunca chega a um servidor controlado por este site.

As duas superfícies públicas em detalhe

O endpoint oEmbed é uma API pública e sem chave do YouTube. Uma única solicitação como https://www.youtube.com/oembed?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&format=json dá a você o título do vídeo, o nome do canal e a URL da miniatura – ou uma recusa clara se o vídeo não puder ser incorporado. Por ser uma sonda de status leve, ela responde em uma única ida e volta.

A superfície do player é a mesma que você usa ao colar um iframe: o YouTube carrega um pequeno player IFrame na página, e os códigos de status do player contam o resto da história. Um player que atinge seu primeiro quadro sem código de erro é a prova de que a incorporação aceitou o vídeo, enquanto um player que dispara um erro nomeia o motivo – não encontrado, removido ou restrito para incorporação. A prévia fica pausada nesse primeiro quadro, exatamente como uma incorporação normal: nada toca sozinho e o volume é o que você definiu.

Casos de uso

Além do óbvio – "este link é seguro para colar?" – a ferramenta se encaixa em fluxos de trabalho reais.

Desenvolvimento web e de aplicativos

Desenvolvedores que incorporam vídeos do YouTube em dashboards, landing pages ou aplicativos costumam ver incorporações quebradas um dia após o lançamento. Adicionar uma verificação prévia durante a importação de conteúdo – geração de sitemap, importação de CMS ou recomendação de vídeo – captura vídeos não incorporáveis e removidos antes que cheguem aos usuários. A mesma sonda oEmbed é fácil de reutilizar como uma linha única em um script de build.

Produção de conteúdo e marketing

Editores que montam páginas promocionais, newsletters ou artigos de base de conhecimento querem vincular muitos vídeos sem vigiar cada incorporação. Uma leva rápida da ferramenta, uma URL por vez, sinaliza os vídeos que seriam renderizados como placeholders quebrados, para que a lista seja publicada limpa.

Pesquisa e triagem de arquivos

Jornalistas, arquivistas e pesquisadores que acompanham a disponibilidade de um vídeo ao longo do tempo podem executar a verificação novamente e arquivar o resultado. O padrão "era incorporável, agora erro 100" é um alerta precoce de que o vídeo foi excluído – um fato útil por si só.

Resultados e códigos de erro

Cada resultado que a ferramenta mostra é a resposta do próprio player, traduzida. O resultado que você lê e o código de erro subjacente vêm da mesma fonte, então as duas camadas nunca se contradizem.

Os resultados:

Os códigos de erro:

Os códigos 101 e 150 levam ao mesmo resultado, Não incorporável – "o proprietário não permite a incorporação". Um 100 significa que o vídeo não está mais disponível publicamente e leva a Vídeo não encontrado. Os códigos 2 e 5 levam ambos a Vídeo indisponível. E um player que permanece em silêncio além da janela de espera leva a Tempo esgotado – o resultado que você encontra quando um script ou uma regra de rede bloqueia o próprio player. Essas são as respostas que você verá com mais frequência ao auditar uma galeria de incorporações.

O que ele detecta e o que não detecta

Ser honesto sobre os limites é parte do que torna esta ferramenta útil. A tabela mostra o que o pipeline de incorporação revela e sobre o que ele se cala.

Cada pergunta que decide o resultado central – a verificação de incorporação, a prova de reprodução, o sinal de removido ou privado – é totalmente respondida sem chave. A camada de enriquecimento – contagens de visualizações, listas de regiões, tags, legendas, datas de upload – é outra história, tratada em "Em comparação com a API oficial".

Uso

O fluxo de trabalho é um interativo de dois campos:

1. Cole um link do YouTube – da barra de endereços, do menu Compartilhar ou da folha de incorporação do vídeo.
2. Pressione Enter ou clique no botão Verificar.
3. Leia o resultado – um selo descreve o resultado como Reproduzível, Não incorporável, Vídeo não encontrado, Vídeo indisponível ou Tempo esgotado.
4. Leia os detalhes – o painel do player lista o título, o canal, a duração e o ID do vídeo sob o selo; as três linhas de sonda abaixo explicam como cada verificação terminou.

Colar não dispara a verificação por si só; ela roda quando você pressiona Verificar ou Enter. Isso mantém a ferramenta previsível – editar o campo nunca descarta de repente um resultado que você está vendo. Se a entrada não for uma URL válida do YouTube, um erro aparece e o campo é esvaziado.

Formatos de link suportados

A entrada aceita os mesmos formatos que o próprio YouTube usa – cole um destes:

Parâmetros extras como playlists e marcas de tempo são ignorados automaticamente.

Tutorial passo a passo

Percorra um vídeo do link ao resultado.

Passo 1 – Pegue um link. Abra qualquer vídeo do YouTube e copie sua URL, por exemplo https://www.youtube.com/watch?v=dQw4w9WgXcQ.

Passo 2 – Cole e verifique. Clique no campo de entrada, cole (Ctrl+V ou Cmd+V) e pressione Enter. O selo muda para Verificando….

Passo 3 – Leia o selo. Em cerca de dois segundos aparece um resultado. Em um upload comum e incorporável, ele diz Reproduzível, apoiado pelas linhas de sonda.

Passo 4 – Compare com um vídeo restrito. Agora cole um link para um clipe musical que a gravadora retém da incorporação – a maioria dos clipes das grandes gravadoras é bloqueada. O resultado diz Não incorporável e a linha de erro mostra 101. É exatamente a falha que se reproduz como uma caixa cinza vazia quando você cola o código de incorporação manualmente.

Passo 5 – Examine as evidências. As linhas de sonda correspondem ao selo: a linha de incorporação mostra Bloqueada e a linha de reprodução não mostra confirmação porque o player falhou antes que você pudesse apertar o play. Essa combinação – incorporação recusada, sem reprodução – é exatamente o sinal de "sem painel de incorporação" que você veria na própria página do YouTube para um vídeo assim.

Esse é o ciclo completo: colar, verificar, ler o selo – e se o resultado divergir de uma incorporação real, use as linhas de sonda para entender por quê.

Dicas profissionais

• Cole um ID de vídeo avulso. A entrada aceita um ID de 11 caracteres sozinho, sem URL – útil quando você trabalha com uma resposta de API, uma exportação de banco de dados ou um link encurtado que só revela o ID.
• Rode novamente com Enter. Editar o link no campo nunca limpa o resultado atual; pressione Enter quando tiver a URL que realmente quer.
• Automatize o portão de incorporação. Se você gera páginas a partir de feeds, pode consultar com curl a mesma sonda oEmbed que a ferramenta usa (https://www.youtube.com/oembed?url=…&format=json) e tratar um status diferente de 200 como "rejeite este vídeo" no seu pipeline.
• Teste conteúdo sensível à região a partir da região-alvo. Se seu público está em um país específico, execute a verificação conectado a essa rede; o player reflete a região para a qual é servido.
• Trate o erro 100 como um sinal de mudança. Um vídeo que passou na verificação e de repente relata 100 foi muito provavelmente removido ou tornado privado. Se você mantém um registro de vídeos incorporados, revifique-os periodicamente – vale saber da mudança de status antes que um visitante encontre o player cinza.

Incorpore o vídeo você mesmo

Um resultado Reproduzível é o sinal verde para usar exatamente a incorporação que a ferramenta verificou:

<div style="aspect-ratio: 16 / 9;">
  <iframe
    src="https://www.youtube-nocookie.com/embed/VIDEO_ID"
    width="100%"
    height="100%"
    frameborder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
    allowfullscreen
    loading="lazy"
  ></iframe>
</div>

• Prefira o domínio nocookie. O youtube-nocookie.com serve o mesmo player sem os cookies não essenciais do YouTube – a escolha padrão que respeita a privacidade para a maioria dos sites.
• loading="lazy" já vem no snippet. Ele adia a incorporação até o vídeo entrar no campo de visão; remova-o para um hero acima da dobra cujo carregamento importa.
• Cuide da sua Content-Security-Policy. Se seu site envia uma CSP, adicione frame-src https://www.youtube-nocookie.com (ou https://www.youtube.com se mantiver o domínio normal), senão a incorporação será bloqueada antes de carregar.

Alternativas

Como os desenvolvedores normalmente descobrem que uma incorporação está quebrada? A tabela completa as opções.

A API Data oficial é a mais completa, mas exige uma chave, roda no servidor para evitar exposição e custa cota por solicitação. Uma sonda de incorporação simples com só código não entrega as mensagens do player nem a prova de reprodução. Um iframe colado cru só conta depois da implantação o que esta ferramenta mostra instantaneamente antes de publicar.

Em comparação com a API oficial

A tabela abaixo compara os dois caminhos honestos para a mesma pergunta: a API Data oficial do YouTube (um servidor, uma chave, uma cota) versus esta ferramenta (só o navegador, sem chave, sem servidor). A comparação é por que "sem chave" é um recurso e não uma limitação – a troca está nas colunas que importam para as incorporações.

As duas superfícies se sobrepõem exatamente na métrica que decide uma incorporação: ele vai tocar em uma página? A API oficial vence em tudo o que conta para análise – metadados, estatísticas, listas de regiões. A ferramenta vence na resposta final: uma incorporação ao vivo que carrega no navegador, pausada no primeiro quadro, onde você pode apertar o play e assistir você mesmo.

Solução de problemas

Privacidade e tratamento de dados

A ferramenta segue o mesmo modelo de privacidade das outras ferramentas da Toollect: tudo roda localmente.

• Nada é enviado. A URL é analisada no seu navegador. Nenhuma solicitação que a contenha é enviada a um servidor que você não controla.
• Sem conta, sem rastreamento. Não há login, nem analytics, nem histórico dos vídeos que você verifica.
• Apenas tráfego do player. As únicas solicitações de rede são as do próprio player – as mesmas que qualquer site faz ao incorporar um vídeo. Nada é salvo, capturado ou armazenado.
• Nenhum vídeo é baixado com antecedência. A prévia pausa no primeiro quadro com um botão de play normal; o stream só começa a carregar quando você aperta o play, como em qualquer incorporação, e nada é salvo.

Se você é cuidadoso com a privacidade dos vídeos que inspeciona, esta página se comporta exatamente como assistir a uma página de vídeo normal no seu navegador – seu link não vai a lugar nenhum além do seu próprio player.

Especificações técnicas

Detalhes:

• Sonda de incorporação: https://www.youtube.com/oembed?url={watch_url}&format=json – HTTP 200 = incorporável, não-200 = restrito
• Player: API IFrame Player do YouTube, carregada sob demanda como incorporação playsinline pausada no primeiro quadro (sem reprodução automática forçada, sem mudo forçado)
• Fontes do resultado: status do oEmbed, códigos de erro do player (2, 5, 100, 101, 150) e eventos de reprodução ao vivo quando você aperta o play
• Metadados: título, canal, duração e ID do vídeo retornados pelo próprio player
• Processamento: JavaScript 100% no cliente, sem chave de API, sem uploads, sem servidor
• Suporte a navegadores: todos os navegadores modernos com suporte a Promise e nível ES5 (Chrome, Edge, Firefox, Safari)

Recursos

• Verificação instantânea da possibilidade de incorporação para qualquer link do YouTube que você colar
• Prévia de incorporação ao vivo, pausada no primeiro quadro, com confirmação de reprodução no momento em que você aperta o play
• Resultados baseados nos códigos de erro do próprio player do YouTube, com explicações em linguagem simples
• Título, canal e duração exibidos sem abrir uma página separada
• Processamento 100% no navegador sem envio de dados, nenhuma chave de API necessária
• Aceita links watch, Shorts, embed, live e youtu.be, além de IDs de vídeo avulsos

Perguntas frequentes