Pular para o conteúdo
PT
Obter chave API

YouTube Data / Python

Obter um canal YouTube vídeos recentes com Python

Leia um canal YouTube por alça, exporte vídeo recente IDs e metadados, e distinga a lista de vídeo retornada da contagem total de vídeo do canal.

FlashData · Publicado

Um perfil de canal conectado a uma fileira de placas de vídeo recentes.

Quando um fluxo de trabalho começa com um criador em vez de um vídeo URL, primeiro recuperar o canal e seus vídeos recentes. Isso lhe dá uma lista limitada de vídeos IDs para metadados ou pedidos de legenda. Este tutorial salva um instantâneo de canal e um simples arquivo ID usando a biblioteca padrão do Python.

O que o terminal do canal retorna

O youtube_channel A fonte aceita uma pega como @jawed; o @ Prefixo é opcional. params.video_limit controla quantas entradas recentes para solicitar, de 1 para 100, com um padrão de 20. Menos vídeos podem estar disponíveis.

Os que voltaram videoCount descreve a contagem total de vídeo do canal. O videos O array contém as entradas recentes retornadas por este pedido. Um pedido para entradas 20 não recupera todo o arquivo do canal, e este ponto final não oferece um parâmetro de página documentado para percorrer todos os uploads históricos.

Estatísticas e imagens do canal podem estar faltando ou null. Mantenha essa distinção em seus dados: uma contagem de assinantes não disponível não é um canal com zero assinantes.

Defina o cabo e um pequeno limite de coleta

Criar um API chave Com créditos disponíveis. Comece com um pequeno limite para inspecionar a resposta antes de planejar um fluxo de trabalho maior. Obtendo dados do canal e depois pegando os metadados de cada vídeo são pedidos API separados.

bash
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'

Salve a imagem do canal e o vídeo IDs

Salve este código como channel-videos.py. O roteiro verifica que a resposta foi completada, extrai o vídeo válido IDs, e preserva os registros de vídeo originais em JSON. Ele escreve cada ID uma vez, mesmo que uma resposta fonte contenha uma entrada duplicada.

python
import json
import os
import re
from pathlib import Path
from urllib.request import Request, urlopen
from urllib.error import HTTPError

key = os.environ["FLASHDATA_API_KEY"]
handle = os.environ.get("YOUTUBE_HANDLE", "@jawed").strip()
limit = int(os.environ.get("VIDEO_LIMIT", "20"))
if not handle or len(handle) > 100:
    raise ValueError("Use a channel handle of at most 100 characters")
if not 1 <= limit <= 100:
    raise ValueError("VIDEO_LIMIT must be between 1 and 100")
request = Request(
    "https://data.flashdata.dev/v1/queries/realtime",
    data=json.dumps({"source": "youtube_channel", "handle": handle,
                     "params": {"video_limit": limit}}).encode(),
    method="POST", headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
    with urlopen(request, timeout=60) as response:
        payload = json.load(response)
except HTTPError as error:
    raise RuntimeError(f"Channel request failed: HTTP {error.code}") from error
if payload.get("error") or payload.get("status") != "done":
    raise RuntimeError("Channel request did not complete. Check Request History before retrying.")
if not isinstance(payload.get("results"), list) or not payload["results"]:
    raise RuntimeError("Expected a channel result")
channel = payload["results"][0]
videos = channel.get("videos")
if not isinstance(videos, list):
    raise RuntimeError("Expected a videos array")
ids = list(dict.fromkeys(
    row["videoId"] for row in videos
    if isinstance(row.get("videoId"), str)
    and re.fullmatch(r"[A-Za-z0-9_-]{11}", row["videoId"])
))
Path("channel.json").write_text(json.dumps({
    "requestedHandle": handle, "requestedLimit": limit,
    "channel": channel, "usage": payload.get("usage"),
}, indent=2), encoding="utf-8")
Path("video-ids.txt").write_text("".join(video_id + "\n" for video_id in ids), encoding="utf-8")
print(f"Saved {len(videos)} returned entries and {len(ids)} unique video IDs")
print("Reported channel video count:", channel.get("videoCount"))
bash
python3 channel-videos.py

Use o IDs para um pedido de acompanhamento focado

A resposta do canal contém registros de vídeo compactos: IDs, títulos, duração, conta de visualização, datas de upload e miniaturas quando disponíveis. Para mais detalhes, envie um desses IDs para youtube_metadata. Leia o ID do arquivo salvo em vez de tentar analisá-lo de um título ou miniatura URL.

json
{"source":"youtube_metadata","video_id":"REPLACE_WITH_VIDEO_ID","params":{"include_formats":false}}

Envie o corpo para o mesmo ponto final em tempo real. O placeholder deve ser substituído por um 11 ID. Se precisar de legendas, use o Guia de linguagem da legenda para decidir qual faixa é aceitável antes de apresentar um pedido.

Planeje coletas repetidas e cargas de trabalho maiores

  • Guarde o vídeo IDs que já processou. Compare fotos futuras com esse conjunto para evitar submeter o mesmo trabalho a jusante repetidamente.

  • Mantenha o tempo de coleta com suas próprias fotos. Contagens podem mudar e um vídeo pode ficar indisponível depois que apareceu em uma resposta do canal.

  • Uma imagem limitada de vídeo recente pode perder uploads ou itens antigos entre corridas infrequentes. Não o descreva como um arquivo completo ou um evento exatamente uma vez.

  • Para vários pedidos a jusante, escolha a sincronização ou processamento de lote dentro dos limites do seu plano. Um grupo agrupa submissões, não torna cada item livre ou remove a necessidade de recuperar os resultados do trabalho.

Veja o Referência do canal API, Video Metadata API e.. Sincronia e guia de lote. Para um primeiro fluxo de trabalho, explore Adicionando ferramentas de busca a um agente de IA.