작업 흐름이 비디오 URL보다 오히려 제작자와 함께 시작될 때, 먼저 채널과 최근 비디오 검색을 검색합니다. 그것은 나중에 메타 데이터 또는 캡션 요청을 위해 비디오 IDs의 경계 목록을 제공합니다. 이 튜토리얼은 Python의 표준 라이브러리를 사용하여 채널 스냅 샷 및 간단한 ID 파일을 저장합니다.
채널 endpoint 반환
의 특징 youtube_channel 소스는 같은 손잡이를 받아들입니다 @jawed; 해당 @ prefix는 선택적입니다. params.video_limit 1에서 100로 요청할 수 있는 많은 최근 항목들을 20의 기본으로 제어합니다. Fewer 동영상은 사용할 수 있습니다.
반환된 videoCount 채널의 총 비디오 카운트를 설명합니다. 의 특징 videos 배열은 이 요청에 의해 반환된 최근 항목이 포함되어 있습니다. 20 항목에 대한 요청은 전체 채널 아카이브를 검색하지 않으며이 엔드포인트는 모든 역사적인 업로드를 걷는 문서화 된 페이지 매개 변수를 제공하지 않습니다.
채널 통계 및 이미지는 누락되거나 null일 수 있습니다. 데이터에 대한 구별을 유지하십시오 : 사용할 수없는 가입자 수는 0 가입자가있는 채널이 아닙니다.
손잡이와 작은 수집 한계를 설정
제품정보 API 열쇠 사용 가능한 크레딧. 더 큰 작업 흐름을 계획하기 전에 응답을 검사하는 작은 한계로 시작하십시오. 각 비디오의 메타데이터가 별도의 API 요청을 읽는 채널 데이터와 나중에 fetching.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_HANDLE='@jawed'
export VIDEO_LIMIT='20'
채널 스냅 샷 및 비디오 IDs 저장
이 코드를 저장하기 channel-videos.py. 스크립트는 응답 완료, 유효 비디오 IDs 추출, JSON의 원래 비디오 레코드를 보존. 소스 응답이 중복 항목이 포함하더라도 한 번에 각 고유 ID를 작성합니다.
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"))
python3 channel-videos.py
IDs를 사용하여 집중된 후속 요청
채널 응답은 컴팩트 한 비디오 레코드를 포함: IDs, 제목, 기간, 보기 수, 업로드 날짜 및 엄밀한 사용할 수 있습니다. 자세한 내용은 IDs 중 하나를 제출 youtube_metadata. 저장된 파일에서 ID를 읽으면 제목이나 엄지나일 URL에서 파싱하려고 합니다.
{"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에 검색 도구를 추가.