본문으로 건너뛰기
KO
API 키 받기

YouTube Data / Python

YouTube 채널의 최근 동영상 받기 Python

핸들로 YouTube 채널을 읽고, 최근 비디오 IDs 및 메타데이터를 내보내고 채널의 총 비디오 카운트에서 반환된 비디오 목록을 구분합니다.

FlashData · 게시됨

최근 비디오 카드의 행에 연결된 채널 프로필

작업 흐름이 비디오 URL보다 오히려 제작자와 함께 시작될 때, 먼저 채널과 최근 비디오 검색을 검색합니다. 그것은 나중에 메타 데이터 또는 캡션 요청을 위해 비디오 IDs의 경계 목록을 제공합니다. 이 튜토리얼은 Python의 표준 라이브러리를 사용하여 채널 스냅 샷 및 간단한 ID 파일을 저장합니다.

채널 endpoint 반환

의 특징 youtube_channel 소스는 같은 손잡이를 받아들입니다 @jawed; 해당 @ prefix는 선택적입니다. params.video_limit 1에서 100로 요청할 수 있는 많은 최근 항목들을 20의 기본으로 제어합니다. Fewer 동영상은 사용할 수 있습니다.

반환된 videoCount 채널의 총 비디오 카운트를 설명합니다. 의 특징 videos 배열은 이 요청에 의해 반환된 최근 항목이 포함되어 있습니다. 20 항목에 대한 요청은 전체 채널 아카이브를 검색하지 않으며이 엔드포인트는 모든 역사적인 업로드를 걷는 문서화 된 페이지 매개 변수를 제공하지 않습니다.

채널 통계 및 이미지는 누락되거나 null일 수 있습니다. 데이터에 대한 구별을 유지하십시오 : 사용할 수없는 가입자 수는 0 가입자가있는 채널이 아닙니다.

손잡이와 작은 수집 한계를 설정

제품정보 API 열쇠 사용 가능한 크레딧. 더 큰 작업 흐름을 계획하기 전에 응답을 검사하는 작은 한계로 시작하십시오. 각 비디오의 메타데이터가 별도의 API 요청을 읽는 채널 데이터와 나중에 fetching.

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

채널 스냅 샷 및 비디오 IDs 저장

이 코드를 저장하기 channel-videos.py. 스크립트는 응답 완료, 유효 비디오 IDs 추출, JSON의 원래 비디오 레코드를 보존. 소스 응답이 중복 항목이 포함하더라도 한 번에 각 고유 ID를 작성합니다.

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

IDs를 사용하여 집중된 후속 요청

채널 응답은 컴팩트 한 비디오 레코드를 포함: IDs, 제목, 기간, 보기 수, 업로드 날짜 및 엄밀한 사용할 수 있습니다. 자세한 내용은 IDs 중 하나를 제출 youtube_metadata. 저장된 파일에서 ID를 읽으면 제목이나 엄지나일 URL에서 파싱하려고 합니다.

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

같은 실시간 엔드포인트로 그 몸을 전송합니다. placeholder는 실제 11-character ID로 대체되어야 합니다. 대신 captions를 필요로 하는 경우에, 사용 관련 링크 요청을 제출하기 전에 해당 트랙이 허용되도록 결정하십시오.

계획 반복된 수집 및 더 큰 workloads

  • 이미 처리 된 비디오 IDs를 저장하십시오. 같은 다운스트림 작업을 반복적으로 제출하기 위해 설정된 미래 스냅 샷을 비교하십시오.

  • 자신의 스냅 샷으로 수집 시간을 유지하십시오. 카운트는 변경할 수 있으며 비디오는 채널 응답에 등장한 후 사용할 수 없습니다.

  • 제한된 최근 비디오 스냅 샷은 오래된 업로드 또는 잘못된 실행 사이에 아이템을 놓을 수 있습니다. 완전한 아카이브 또는 정확히 온스 이벤트 피드로 설명하지 마십시오.

  • 여러 다운스트림 요청을 위해, 플랜의 제한 내에서 동기화 또는 일괄 처리를 선택합니다. 일괄 그룹 제출; 그것은 각 항목 무료 또는 작업 결과를 검색 할 필요가 제거하지 않습니다.

더 보기 채널 API 참조, 비디오 메타데이터 API 으로 async 및 일괄 가이드. Search-first 워크플로우를 위해, 탐구 AI Agent에 검색 도구를 추가.