Semak dokumentasi
Contoh
Kemudia mengubah YouTube video ID menjadi rekaman tersimpan judul, saluran, durasi dan jumlah yang tersedia. Simpan respon asli dan penggunaan bersama itu.
Pada halaman ini
Sebelum kau mulai
Gunakan kunci dengan kebenaran youtube_metadata dan kredit yang tersedia. Pilih Python 3.10+ dengan requests, atau Bash dengan cURL 7.76+ dan jq. Pada Windows, gunakan Git Bash untuk versi Bash.
1. Pilih satu video
Sekarang membuat folder video metadata dan menyimpan request.json disana. Buka terminal di dalam folder itu. Renang video_id dengan 11-karakter ID dari jam URL atau hasil YouTube Search; jangan lulus URL penuh.
Tetapkan kedua bendera opsional secara eksplisit: permintaan pertama ini mengabaikan format media dan bab. Ia mengambil data meta tanpa mengunduh video atau kapsinya.
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"params": {
"include_formats": false,
"include_chapters": false
}
}2. Ambil dan simpan data metanya
Ia memilih salah satu versi dan menyimpan skripnya di samping request.json. Ia membaca FLASHDATA_API_KEY atau meminta kunci anda pada prompt tersembunyi. Agen-agen Agen harus memuat bahwa variabel lingkungan dari toko rahasia mereka.
Lulus dengan snapshot-001 sebagai folder keluaran. Sebuah folder baru mengirim satu pertanyaan metadata dan menyimpan penggunaannya yang dilaporkan. script checks untuk respon sukses yang berisi tepat satu video dengan ID yang diminta sebelum menulis video.json.
python -m pip install requestsimport argparse
import getpass
import json
import os
import re
from datetime import datetime, timezone
from pathlib import Path
import requests
parser = argparse.ArgumentParser()
parser.add_argument("folder", help="New output folder, or an existing saved snapshot")
out = Path(parser.parse_args().folder)
if not out.exists():
body = Path("request.json").read_bytes()
request = json.loads(body)
if (not isinstance(request, dict) or request.get("source") != "youtube_metadata"
or not isinstance(request.get("video_id"), str)
or not re.fullmatch(r"[A-Za-z0-9_-]{11}", request["video_id"])):
raise SystemExit("Use youtube_metadata and an 11-character video_id, not a URL")
key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
if not key.strip():
raise SystemExit("An API key is required")
out.mkdir()
(out / "request.json").write_bytes(body)
(out / "requested-at.txt").write_text(
datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), encoding="utf-8"
)
try:
response = requests.post(
"https://data.flashdata.dev/v1/queries/realtime",
headers={"X-API-Key": key, "Content-Type": "application/json",
"Accept": "application/json"},
data=body, timeout=120, allow_redirects=False,
)
except requests.RequestException:
raise SystemExit(f"Request interrupted. Keep {out} and check History before retrying.")
(out / "result.json").write_bytes(response.content)
(out / "response-headers.txt").write_text(
"\n".join(f"{k}: {v}" for k, v in response.headers.items()), encoding="utf-8"
)
(out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
else:
print(f"Reading saved response from {out}; no API call.")
if not (out / "http-status.txt").exists():
raise SystemExit("Incomplete attempt. Keep the folder and check History before retrying.")
status = (out / "http-status.txt").read_text().strip()
if status != "200":
raise SystemExit(f"HTTP {status}: inspect {out}/result.json and response-headers.txt")
try:
data = json.loads((out / "result.json").read_bytes())
except ValueError:
raise SystemExit("Invalid JSON; inspect the saved result.json")
request = json.loads((out / "request.json").read_bytes())
if not isinstance(data, dict) or data.get("source") != "youtube_metadata" or data.get("status") != "done":
raise SystemExit("Metadata request did not finish successfully; inspect result.json")
videos = data.get("results")
if (not isinstance(videos, list) or len(videos) != 1 or not isinstance(videos[0], dict)
or videos[0].get("videoId") != request["video_id"]):
raise SystemExit("Expected one metadata object matching the requested video_id")
record = {
"request": request,
"requested_at": (out / "requested-at.txt").read_text().strip(),
"usage": data.get("usage"), "result_file": "result.json",
}
for filename, value in (("video.json", videos[0]), ("record.json", record)):
(out / filename).write_text(json.dumps(value, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"Saved {videos[0]['videoId']} to {out}/video.json")
python metadata.py snapshot-001curl --version
jq --version#!/usr/bin/env bash
set -euo pipefail
out="${1:?Usage: bash metadata.sh OUTPUT_FOLDER}"
if [[ ! -e "$out" ]]; then
jq -e '.source == "youtube_metadata" and
(.video_id | if type == "string" then length == 11 and test("^[A-Za-z0-9_-]{11}$")
else false end)' request.json > /dev/null
if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
fi
: "${FLASHDATA_API_KEY:?An API key is required}"
mkdir -- "$out"
cp request.json "$out/request.json"
date -u +'%Y-%m-%dT%H:%M:%SZ' > "$out/requested-at.txt"
curl --fail-with-body --silent --show-error --max-time 120 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' --header 'Accept: application/json' \
--data-binary "@$out/request.json" \
--dump-header "$out/response-headers.txt" --output "$out/result.json" \
--write-out '%{http_code}' > "$out/http-status.txt" || {
printf 'Request failed. Keep %s and inspect its saved files before retrying.\n' "$out" >&2
exit 1
}
else
printf 'Reading saved response from %s; no API call.\n' "$out"
fi
if [[ ! -f "$out/http-status.txt" ]] || [[ "$(cat "$out/http-status.txt")" != 200 ]]; then
printf 'Incomplete or failed attempt. Inspect the saved files and History before retrying.\n' >&2
exit 1
fi
video=$(jq -e --slurpfile request "$out/request.json" '
if .source != "youtube_metadata" or .status != "done"
then error("Expected a successful youtube_metadata response") else . end
| .results
| if type != "array" then error("Expected a metadata array")
elif length != 1 then error("Expected exactly one video") else .[0] end
| if type != "object" then error("Expected a metadata object")
elif .videoId != $request[0].video_id then error("Returned videoId does not match the request")
else . end' "$out/result.json")
printf '%s\n' "$video" > "$out/video.json"
jq --slurpfile request "$out/request.json" \
--arg requested_at "$(tr -d '\r\n' < "$out/requested-at.txt")" \
'{request: $request[0], requested_at: $requested_at, usage, result_file: "result.json"}' \
"$out/result.json" > "$out/record.json"
printf 'Saved %s to %s/video.json\n' "$(jq -r .videoId "$out/video.json")" "$out"
bash metadata.sh snapshot-0013. Bacalah rekaman videonya
Sidik jari sukses yang disimpan <video ID> ke snapshot-001/video.json. Baca berkas tersebut untuk objek data meta penuh dan record.json untuk permintaan yang diajukan secara tepat, requested_at dan penggunaan. Pembacaan file ini tidak membuat panggilan API.
python -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.jsoncat snapshot-001/video.json
cat snapshot-001/record.jsonContoh output
video.json. Nilai yang telah dikembalikan bervariasi. Naskah ini melestarikan setiap bidang yang tersedia, termasuk nilai null, dan menjaga respon lengkap dalam result.json.
{
"videoId": "FUfGcZ092b0",
"title": "Example research video",
"channel": "Example channel",
"duration": 120,
"viewCount": null,
"transcriptLanguages": [
"en"
]
}Baca ladangnya
| Ukrainian | Gunalah untuk |
|---|---|
| videoId | Catatan kunci stabil. Gelaran dan nama tampilan saluran dapat berubah. |
| duration | Panjang video dalam detik. Simpanan nilai hilang atau null sebagai tidak diketahui. |
| viewCount / likeCount / commentCount | Hitungan yang tersedia dalam petikan ini. Nama Null atau hilang tidak diketahui; nol adalah jumlah yang dilaporkan. |
| transcriptLanguages | Kode Bahasa Calon Calon Anak untuk permintaan kapsi yang terpisah. Daftar ini tidak mengidentifikasi apakah trek otomatis atau manual. |
Gunakan kembali snapshot atau permintaan lain
Mengelabui perintah yang sama untuk membangun kembali video.json dan record.json dari respon yang disimpan. Tidak ada kunci atau permintaan jaringan yang diperlukan. Pengeditan request.json tidak mengubah masukan yang disimpan dengan snapshot-001.
python metadata.py snapshot-001bash metadata.sh snapshot-001Termasuk bab - bab yang tersedia
Untuk menyertakan penanda bab, ganti request.json dengan versi ini dan gunakan folder keluaran baru. include_chapters: true mengembalikan bab ketika tersedia; tidak membuatnya. Baik include_chapters maupun include_formats baku ke true ketika diabaikan.
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"params": {
"include_formats": false,
"include_chapters": true
}
}python metadata.py snapshot-002bash metadata.sh snapshot-002Jika data meta data meta tidak tersedia
| Apa yang terjadi? | Tindakan |
|---|---|
| video_id tidak sah | Hanya menggunakan 11-karakter ID. Pengesahan input formoid berhenti sebelum mengirim permintaan. |
| Private, dihapus atau video terbatas | Tetap gagal untuk ID. Tak perlu lagi mengirimkan barang yang sama. |
| Hasil kosong atau videoId yang berbeda | Naskah berhenti tanpa menulis video.json. Periksa permintaan dan tanggapan yang disimpan sebelum menggunakan catatan. |
| Cacat, bab, atau bahasa yang hilang | Sebuah catatan metadata yang cocok masih bisa sukses. Simpan field yang tidak tersedia sebagai tidak diketahui; jangan isi dengan nilai-nilai yang diciptakan. |
| 401 / 403 / 402 | Periksa kuncinya, youtube_metadata izin dan keseimbangan, masing-masing, sebelum percobaan baru. |
| 429 | Toanny Baca Retry-After di response-headers.txt dan tunggu. Naskah tidak pernah mengulang secara otomatis. |
| Had waktu habis, 5xx, JSON tidak sah atau folder tidak lengkap | Jangan coba-coba dan periksa History sebelum mengirimkan lagi. Melepaskan kembali foldernya tidak membuat permintaan baru. |
Simpan inspect_metadata.py di samping metadata.py, kemudian jalankan.
from pathlib import Path
for name in ("http-status.txt", "response-headers.txt", "result.json"):
path = Path("snapshot-001") / name
print(f"--- {name} ---")
print(path.read_text(encoding="utf-8", errors="replace") if path.exists() else "Not saved")python inspect_metadata.pyfor name in http-status.txt response-headers.txt result.json; do
printf '\n--- %s ---\n' "$name"
if [[ -f "snapshot-001/$name" ]]; then cat "snapshot-001/$name"; else printf 'Not saved\n'; fi
doneGuna video dalam alur kerja Anda
Use videoId untuk bergabung dengan rekor ini ke hasil pencarian atau dataset anda. Untuk konten yang diucapkan, ambil gambar tertentu selanjutnya. Untuk beberapa IDs, gunakan panduan pengayaan. Ini adalah permintaan terpisah dengan izin dan tuntutan mereka sendiri.