Voltar às Rotas do YouTube

Vídeo Mais Recente de um Canal do YouTube

Essa rota possui cache e nem sempre estará completamente atualizada. Confira a página de rotas em cache para obter mais informações.

Propósito:

Recupera o vídeo mais recente enviado para o canal do YouTube especificado.

URL:

https://api.zezofelipe.com.br/youtube/latestvideo 

Se um canal do YouTube tem URL no formato /c/zezofelipe, você deve usar id. Um método para recuperar seu ID de canal é visitando as Configurações avançadas e copiando o ID do canal.

Parâmetros de Consulta:

Nome	Descrição	Obrigatório	Tipo
`exclude`	Exclui vídeos que contenham o texto especificado no título do vídeo. Não diferencia maiúsculas de minúsculas.	Não	`string`
`format`	Personaliza o formato de saída do vídeo mais recente. Variáveis disponíveis: `{title}`, `{id}`, `{url}`. Formato padrão: `{title} - {url}`	Não	`string`
`handle`	Identificador do canal do YouTube.	Não*	`string`
`id`	ID do canal do YouTube.	Não*	`string`
`include`	Inclui apenas vídeos que contenham o texto especificado no título do vídeo. Não diferencia maiúsculas de minúsculas.	Não	`string`
`max_duration`	Excluirá qualquer vídeo com duração maior que a quantidade especificada de segundos.	Não	`integer`
`min_duration`	Excluirá qualquer vídeo com duração menor que a quantidade especificada de segundos.	Não	`integer`
`no_livestream`	Excluirá qualquer live ativa e VODs de lives já transmitidas.	Não	`boolean`
`no_shorts`	Excluirá qualquer vídeo com menos de 1 minuto, também conhecidos como Shorts.	Não	`boolean`
`shorts_url`	Se o vídeo for um Short, a URL será retornada como uma URL de shorts.	Não	`boolean`
`skip`	Pula a quantidade especificada de vídeos enviados. Padrão: `0`. Máximo: `50`.	Não	`integer`
`user`	Para usuários com URLs formatadas como: `youtube.com/user/[USERNAME]`	Não*	`string`

* Pelo menos um dos parâmetros user, id ou handle deve ser especificado. Se ambos id e user forem especificados, id será usado.

** Parâmetros booleanos aceitam true ou 1 como verdadeiro.

Exemplos:

Vídeo mais recente do canal do Cadamuro usando identificador:

https://api.zezofelipe.com.br/youtube/latestvideo?handle=@CadamuroYT

Vídeo mais recente excluindo shorts e transmissões ao vivo:

https://api.zezofelipe.com.br/youtube/latestvideo?handle=@CadamuroYT&no_shorts=true&no_livestream=true

Vídeo mais recente com formato personalizado:

https://api.zezofelipe.com.br/youtube/latestvideo?handle=@CadamuroYT&format=Assista:%20{title}%20em%20{url}

Retornar o segundo vídeo mais recente:

https://api.zezofelipe.com.br/youtube/latestvideo?handle=@CadamuroYT&skip=1

Rota alternativa que retorna apenas URL do vídeo mais recente:

https://api.zezofelipe.com.br/youtube/latestvideo/url?handle=@CadamuroYT&shorts_url=true

Commandos de Bot:

$(customapi.https://api.zezofelipe.com.br/youtube/latestvideo?handle=@SEU_IDENTIFICADOR)

Resposta JSON:

{ 
  "success": true, 
  "video": { 
    "id": "azuRIpvlQH8", 
    "title": "ALIEN TRILOGY (PS1) - Cutscenes Legendadas", 
    "url": "https://www.youtube.com/watch?v=azuRIpvlQH8", 
    "duration": 311, 
    "is_short": false, 
    "is_livestream": false, 
    "published_at": "2024-04-26T23:28:11Z", 
    "channel": { 
      "id": "UCyinhX2TL5uJZj7sH9wxd4Q", 
      "title": "Zezo" 
    } 
  }, 
  "search_criteria": { 
    "handle": "@ZezoFelipe", 
    "skip": 0, 
    "no_shorts": false, 
    "no_livestream": false 
  }, 
  "cached": true, 
  "timestamp": "2025-11-11T04:07:46.501Z" 
} 

Resposta de texto:

ALIEN TRILOGY (PS1) - Cutscenes Legendadas - https://www.youtube.com/watch?v=azuRIpvlQH8 