Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Contoh

Ambil metadata satu video

Putar video YouTube ID ke dalam catatan tersimpan judul, saluran, durasi dan jumlah yang tersedia. Simpan respon asli dan penggunaan di sampingnya.

Di halaman ini

Sebelum Anda mulai

Gunakan kunci dengan izin youtube_metadata dan kredit yang tersedia. Pilih Python 3.10+ dengan permintaan, atau Bash dengan cURL 7.76+ dan jq. Hidup Windows, gunakan Git Bash untuk Bash versi.

1. Pilih satu video

Buat folder video- metadata dan simpan request.json di sana. Buka terminal pada folder itu. Ganti video_id dengan 11-character ID dari pengawasan. URL atau YouTube Search hasil; jangan lulus penuh URL.

Set kedua tanda opsional secara eksplisit: permintaan pertama ini menghilangkan format media dan bab. Ia mengambil metadata tanpa mengunduh video atau takarannya.

video-metadata/request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}

2. Ambil dan simpan metadata

Pilih satu versi dan simpan script di samping request.json. Tertulis FLASHDATA_API_KEY atau meminta kunci Anda pada prompt tersembunyi. Agen harus memuat variabel lingkungan dari toko rahasia mereka.

Jalankan dengan snapshot - 001 sebagai folder keluaran. Folder baru mengirim satu kuiri metadata dan menyimpan penggunaan yang dilaporkan. Cek skrip untuk respon sukses berisi satu video dengan ID yang diminta sebelum menulis video.json.

Pasang di lingkungan Python Anda
python -m pip install requests
video-metadata/metadata.py
import 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")
Jalankan dari video-metadata /
python metadata.py snapshot-001

3. Baca rekaman video

Cetakan sukses disimpan < video ID > ke snapshot-001/video.json. Baca berkas itu untuk objek metadata lengkap dan record.json untuk permintaan yang diajukan secara tepat, requested_at dan penggunaan. Membaca berkas ini tidak membuat panggilan API.

Baca lokal
python -m json.tool snapshot-001/video.json
python -m json.tool snapshot-001/record.json

Contoh keluaran

Abbreviated, illustratif video.json. Nilai dikembalikan bervariasi. Skrip mempertahankan setiap ruas yang tersedia, termasuk nilai null, dan menyimpan respon lengkap dalam result.json.

video-metadata/snapshot-001/video.json
{
  "videoId": "FUfGcZ092b0",
  "title": "Example research video",
  "channel": "Example channel",
  "duration": 120,
  "viewCount": null,
  "transcriptLanguages": [
    "en"
  ]
}

Baca bidang

RuasGunakan untuk
videoIdRekor itu kunci stabil. Judul dan nama tampilan saluran dapat berubah.
durationPanjang video dalam hitungan detik. Pertahankan nilai-nilai yang hilang atau null sebagai tidak diketahui.
viewCount / likeCount / commentCountMenghitung tersedia dalam snapshot ini. Nuklir atau hilang tidak diketahui; nol adalah jumlah yang dilaporkan.
transcriptLanguagesKode bahasa kandidat untuk permintaan judul terpisah. Daftar ini tidak mengidentifikasi apakah trek otomatis atau manual.

Gunakan lagi snapshot atau permintaan lain

Jalankan perintah yang sama untuk membangun kembali video.json dan record.json dari respon yang disimpan. Tak ada permintaan kunci atau jaringan yang diperlukan. Menyunting level atas request.json tidak mengubah masukan yang tersimpan dengan snapshot - 001.

Gunakan ulang data yang disimpan
python metadata.py snapshot-001

Sertakan bab yang tersedia

Untuk memasukkan penanda bab, ganti request.json dengan versi ini dan gunakan folder keluaran baru. include_chapters: true mengembalikan bab bila tersedia; ini tidak membuat mereka. Baik include_chapters maupun include_formats baku ke true ketika diabaikan.

video-metadata/request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
Meminta snapshot lain
python metadata.py snapshot-002

Jika metadata tidak tersedia

Apa yang terjadi?Yang perlu dilakukan
video_id tidak validGunakan hanya karakter 11- ID. Validasi masukan berhenti sebelum mengirim permintaan.
Pribadi, dihapus atau video dibatasiSimpan kegagalan untuk itu ID. Periksa kesalahan sumber dan pilih video yang dapat diakses daripada berulang kali mengirimkan item yang sama.
Hasil kosong atau videoId yang berbedaNaskah berhenti tanpa menulis video.json. Inspeksi permintaan dan jawaban yang tersimpan sebelum memakai catatan.
Hilang jumlah, bab atau bahasaCatatan metadata yang cocok masih bisa sukses. Pertahankan ruas yang tak tersedia sebagai tak dikenal; jangan isi dengan nilai yang ditemukan.
401 / 403 / 402Periksa kuncinya, youtube_metadata izin dan keseimbangan, secara terhormat, sebelum usaha baru.
429Baca Retry-After in response-headers.txt dan menunggu. Skrip tidak pernah mengulang secara otomatis.
Timeout, 5xx, JSON tidak valid atau sebuah folder tidak lengkapTerus berusaha dan periksa History sebelum mengirimkan lagi. Menggunakan kembali folder tidak membuat permintaan baru.

Simpan inspect_metadata.py di samping metadata.py, kemudian jalankan.

video-metadata/inspect_metadata.py
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")
Inspeksi secara lokal
python inspect_metadata.py

Gunakan video dalam alur kerja Anda

Gunakan videoId untuk bergabung dengan rekaman ini ke hasil pencarian atau data. Untuk isi yang diucapkan, ambil trek judul spesifik berikutnya. Untuk beberapa IDs, gunakan panduan pengayaan. Ini adalah permintaan terpisah dengan hak mereka sendiri dan biaya.