Início
Documentação
get_video_info

get_video_info

Devolve informações públicas de um vídeo do YouTube. Não usa a cota de transcrições. Exige uma conta, como as outras ferramentas.

Consultar metadados do YouTube. REST: POST /v1/info

Parâmetros

Envie o link do vídeo no campo obrigatório.

Nome	Tipo	Obrigatório	Descrição
`url`	string	Sim	URL ou ID de um vídeo do YouTube. Aceita os mesmos formatos de link das outras ferramentas; playlists não são aceitas.

Exemplos

O exemplo usa uma oficina fictícia do próprio usuário.

Peça ao seu assistente

Consulte o título, o canal, a duração e os idiomas das legendas deste vídeo: youtu.be/MinhaAula_0

O assistente chama get_video_info com {"url": "youtu.be/MinhaAula_0"} e responde com os metadados.

curl

curl -X POST https://mcp.mcptube.com/v1/info \
  -H "Authorization: Bearer mct_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"url": "youtu.be/MinhaAula_0"}'

Resposta

A resposta contém as informações solicitadas.

Na API REST, o resultado vem diretamente em JSON com HTTP 200, sem job. No MCP, o primeiro bloco é um resumo, como Minha oficina | Meu canal | 42:00. O bloco seguinte contém os mesmos campos em linhas campo: valor, com listas e objetos recuados, sem JSON. Exemplo da resposta REST:

200 OK

{
  "videoId": "MinhaAula_0",
  "url": "https://www.youtube.com/watch?v=MinhaAula_0",
  "title": "Planilha do zero para pequenos negócios",
  "channel": "Ana Ribeiro | Finanças sem Mistério",
  "channelId": "UCa9Rk2pLm7QwX4sTn1vB3cE",
  "durationSeconds": 2520,
  "uploadDate": "2026-10-21",
  "viewCount": 1240,
  "category": "Educação",
  "keywords": [
    "planilha",
    "finanças",
    "pequenos negócios"
  ],
  "description": "Uma oficina sobre como organizar as finanças de um pequeno negócio.",
  "thumbnailUrl": "https://i.ytimg.com/vi/MinhaAula_0/hqdefault.jpg",
  "isLive": false,
  "chapters": [
    {
      "title": "Por que separar por categoria",
      "start": 130,
      "end": 875
    },
    {
      "title": "Montando a planilha ao vivo",
      "start": 875,
      "end": 1880
    },
    {
      "title": "Três erros comuns",
      "start": 1880,
      "end": 2520
    }
  ],
  "subtitles": [
    {
      "language": "pt",
      "name": "Português",
      "autoGenerated": false
    }
  ]
}

Campo	Conteúdo
`videoId`, `url`	ID e endereço do vídeo.
`title`, `channel`, `channelId`	Título, nome e ID do canal. `channelId` pode ser `null`.
`durationSeconds`, `uploadDate`, `viewCount`	Duração em segundos, data de publicação e visualizações.
`category`, `keywords`, `description`	Categoria, palavras-chave e descrição.
`thumbnailUrl`, `isLive`	Endereço da miniatura e indicação de transmissão ao vivo.
`chapters`	Capítulos disponíveis; lista vazia quando não houver.
`subtitles`	Legendas disponíveis, com `language`, `name` e `autoGenerated` indicando se são automáticas. Não inclui o texto das legendas.

Limites

As consultas compartilham metadataPerDay com search_videos e get_video_comments, sem usar a cota de transcrições. Cada consulta concluída ou página de busca ou comentários concluída, inclusive vazia, usa 1 metadado. Falhas e bloqueios não são cobrados. O limite de 10 chamadas por minuto é compartilhado com search_videos, get_video_comments e get_usage, incluindo as rotas REST correspondentes.

Limite	Gratuito	Starter	Pro
Metadados por dia, compartilhados	50	600	5.000
Chamadas por minuto, compartilhadas	10	10	10

Erros

Use o código para escolher o próximo passo.

Situação	Código	HTTP	O que fazer
URL inválida ou playlist	`invalid_url`	400	Conferir o link do vídeo
Vídeo indisponível	`video_unavailable`	404	Conferir a disponibilidade
Muitas chamadas por minuto	`rate_limited`	429	Aguardar o tempo de Retry-After
Limite diário atingido	`metadata_daily_limit`	429	Aguardar até 0h UTC
Não foi possível processar o vídeo agora	`youtube_blocked`	503	Tentar de novo em alguns minutos

Ver todos os códigos de erro.