Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Praktik terbaik YouTube Data

Population Cari video yang relevan, pilih trek kapsi dan proses unggahan saluran baru tanpa mengulangi pekerjaan.

Pada halaman ini

Mulailah dengan informasi yang sudah kau punya

Setiap sumber menjawab pertanyaan yang berbeda. Skip penemuan untuk video yang diketahui ID atau handle saluran, dan hanya memperkaya video yang diperlukan tugas Anda.

Tugas AndaSumberKeputusan
Memerlukan video tentang topikyoutube_searchMulai dengan lima kandidat, lalu pilih dengan relevansi.
Periksalah sebuah video yang dikenalyoutube_metadataBahasa wikipedia.
Ringkaskan atau petik perkara yang disebutyoutube_transcript / youtube_captionsPilih bahasa dan trek otomatis atau manual.
Periksa unggahan saluran terbaruyoutube_channelAquimation mengembalikan IDs dengan IDs yang telah diproses.

Contoh permintaan dalam contoh permohonan

Simpan masing-masing badan JSON menggunakan nama file yang ditampilkan. Python menggunakan pembantu query.py di bawah ini; cURL dapat mengirimkan berkas yang sama. Guna kunci dengan izin sumber yang Anda butuhkan dan kredit yang tersedia. Setiap penyerahan adalah satu pertanyaan, terlepas dari jumlah video yang dikembalikan.

Python 3.10+. Permintaan pemasangan woaper sekali, simpan query.py di bawah, kemudian gunakan perintah di samping setiap permintaan. Keluaran yang telah ada digunakan kembali; masukan yang diubah memerlukan nama berkas keluaran baru.

Pasang
python -m pip install requests

Ketikkan kunci API anda

Gunakan kembali FLASHDATA_API_KEY dari terminal atau toko rahasia Anda. Jika tidak, masukkan kunci menggunakan satu tanda tangan tersembunyi di bawah. Tetap dalam proses menjalankan contoh-contoh ini.

Mematur kunci
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

Simpan query.py untuk contoh Python

Buat query.py di folder kerja baru dan salin kode lengkap di bawahnya. Simpan berkas JSON permintaan dan skrip Python lainnya di folder ini, dan jalankan semua perintah dari sana.

query.py
# query.py — submit a saved request once, then reuse its response.
import json
import os
import sys
from pathlib import Path
import requests

if len(sys.argv) != 3:
    raise SystemExit("Usage: python query.py REQUEST.json RESULT.json")
payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2])
marker = output.with_name(output.name + ".request.json")
receipt = output.with_name(output.name + ".http.json")
if marker.exists():
    if json.loads(marker.read_text()) != payload:
        raise SystemExit("Changed request: choose a new output filename.")
    if not output.exists() or not receipt.exists():
        raise SystemExit("Outcome unknown: check History before resubmitting.")
    saved = json.loads(receipt.read_text())
    if saved["status"] != 200 or json.loads(output.read_text(encoding="utf-8")).get("status") != "done":
        raise SystemExit(f"Saved request failed or incomplete; Retry-After: {saved['retry_after']}. Inspect {output}.")
    print(f"Read the saved {output}; no new query submitted.")
    raise SystemExit(0)
if output.exists():
    raise SystemExit("Output already exists. Read it or choose a new filename.")
key = os.environ["FLASHDATA_API_KEY"]
with marker.open("x", encoding="utf-8") as file:
    json.dump(payload, file)
response = requests.post("https://data.flashdata.dev/v1/queries/realtime",
                         headers={"X-API-Key": key}, json=payload,
                         timeout=70, allow_redirects=False)
output.write_text(response.text, encoding="utf-8")
receipt.write_text(json.dumps({"status": response.status_code,
                               "retry_after": response.headers.get("Retry-After")}), encoding="utf-8")
if response.status_code != 200:
    raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
if response.json().get("status") != "done":
    raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"saved": str(output), "usage": response.json().get("usage")}, indent=2))

Para calon akan mencari calon sebelum mengambil rinciannya

Filter video mengecualikan jenis hasil lain; subtitel mempersempit penemuan ke video dengan kapsi. Ini tidak memilih bahasa kapsi atau menjamin trek yang Anda butuhkan. Simpan sebagai discover-request.json.

discover-request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video",
      "subtitles": true
    }
  }
}
Lepaskan sekali dengan query.py
python query.py discover-request.json search.json

Pilih berdasarkan relevansi, bukan ID pertama

Simpan candidates.py di samping query.py dan search.json, kemudian jalankan dari folder itu. Ia menyimpan urutan pencarian dan menghapus video ganda IDs. Periksa gelar, saluran dan durasi, kemudian salin ID yang dipilih ke dalam permintaan berikutnya. Daftar kosong adalah pencarian selesai tanpa kandidat.

candidates.py
# candidates.py — read a saved response; no API calls.
import json
import re
from pathlib import Path

data = json.loads(Path("search.json").read_text(encoding="utf-8"))
if data.get("status") != "done":
    raise SystemExit("Search did not complete; inspect search.json.")
candidates, seen = [], set()
for item in (data.get("results") or [{}])[0].get("results", []):
    video_id = item.get("videoId", "")
    if not re.fullmatch(r"[A-Za-z0-9_-]{11}", video_id) or video_id in seen:
        continue
    seen.add(video_id)
    candidates.append({"videoId": video_id, "title": item.get("title"),
                       "channel": item.get("channel"), "duration": item.get("duration"),
                       "url": "https://www.youtube.com/watch?v=" + video_id})
Path("candidates.json").write_text(json.dumps(candidates, indent=2), encoding="utf-8")
print(json.dumps(candidates, indent=2))
Membaca pencarian yang disimpan
python candidates.py

Ekspansi hanya bila daftar pendek tidak mencukupi

Pencarian Standar Diagnosis mendukung max_results hingga 20. Untuk koleksi yang lebih luas, beralih ke youtube_search_extended, yang mendukung hingga 700 dan memiliki pricing terpisah. Contoh ini meminta 50; periksa apakah hasil pertama Anda berguna sebelum memperkaya mereka semua.

extended-request.json
{
  "source": "youtube_search_extended",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 50,
    "filters": {
      "type": "video"
    }
  }
}
Jalankan sekali
python query.py extended-request.json extended.json

Hanya ambil data meta yang diperlukan fitur Anda

Merebut sampel video_id dengan ID pilihan anda. Simpan format dan bab yang dilumpuhkan untuk kartu video sederhana atau cek bahasa kapsi. Memungkinkan include_chapters untuk garis luar, atau include_formats ketika memilih format media.

metadata-request.json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}
Lepaskan sekali dengan query.py
python query.py metadata-request.json metadata.json

Periksa bahasa yang tersedia

Hasil Bacaan DVD[0].transcriptLanguages sebelum memilih kapsi. Format, bab dan bahasa adalah bidang pada objek video yang dikembalikan; catatan penggunaannya tergolong sebagai respon luar.

PemadapanGunalah untuk
languageKode dari transcriptLanguages, seperti en atau zh-Hans. Daftar ini tidak membedakan trek manual dan otomatis.
auto: trueSebuah lintasan yang telah dijana secara otomatis.
auto: falseSebuah trek yang disediakan secara manual. Tidak ada kehancuran di antara dua tipe trek.
Bacalah metadata.json · tidak ada pertanyaan
python -m json.tool metadata.json

Tak ada bahasa dan trek yang dipilih

Gunakan video_id yang sama dengan permintaan data meta Anda dan ubah bahasa dan auto untuk mencocokkan trek yang dipilih. youtube_transcript baku ke auto: true; youtube_captions baku ke auto: false. Kedua-duanya mengambil gambar yang sudah ada, bukan teks pidato.

captions-request.json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": "en",
    "auto": true
  }
}
Lepaskan sekali dengan query.py
python query.py captions-request.json captions.json

Jaga timestamp dengan bukti

Simpan cite-segments.py di samping captions.json dan jalankan dari folder itu. Hasil penggunaan freak[0].segmen untuk kutipan: awal dan akhir adalah detik. Simpanan languageCode dan isAutoGenerated dengan teks. fullText berguna untuk membaca, tetapi tidak menggantikan waktu segmen. Jika trek yang dipilih hilang, rekam celah sebelum memutuskan apakah pertanyaan lain tidak berguna.

cite-segments.py
import json
from pathlib import Path

response = json.loads(Path("captions.json").read_text(encoding="utf-8"))
if response.get("status") != "done":
    raise SystemExit("Inspect captions.json before continuing.")
track = (response.get("results") or [{}])[0]
if not track.get("segments"):
    raise SystemExit("No caption evidence was returned.")
for segment in track["segments"][:3]:
    url = f"https://www.youtube.com/watch?v={track['videoId']}&t={int(segment['start'])}s"
    print(segment["text"], url)
Tak ada panggilan API
python cite-segments.py

Hanya proses-proses proses-proses baru dari saluran yang dikenal

Takashi menggunakan handle saluran dan video_limitQ (1–100Q). results[0].video adalah daftar terbaru yang dikembalikan; videoCount adalah data meta saluran, bukan jumlah item yang dikembalikan. Pilihlah batas dan jadwal yang mencakup unggahan yang perlu diamati.

channel-request.json
{
  "source": "youtube_channel",
  "handle": "@TED",
  "params": {
    "video_limit": 10
  }
}
Lepaskan sekali dengan query.py
python query.py channel-request.json channel.json

Buat antrian dan titik pemeriksaan selesai

Simpan channel-queue.py di samping query.py dan channel.json, dan jalankan dari folder itu. Lari tanpa argumen untuk membuat new-ids.json, kemudian memproses dan menyimpan bukti untuk IDs tersebut. Eligoza menjalankan --commit hanya setelah setiap antrian ID berhasil; kegagalan meninggalkan checkpoint tidak berubah. Use one directory per channel dan satu pekerja untuk contoh ini.

channel-queue.py
# channel-queue.py — plan first; commit only after every queued video is processed.
import json
import re
import sys
from pathlib import Path

checkpoint = Path("processed-ids.json")
processed = set(json.loads(checkpoint.read_text()) if checkpoint.exists() else [])
queue = Path("new-ids.json")
if sys.argv[1:] == ["--commit"]:
    processed.update(json.loads(queue.read_text()))
    temporary = checkpoint.with_suffix(".tmp")
    temporary.write_text(json.dumps(sorted(processed)), encoding="utf-8")
    temporary.replace(checkpoint)
    queue.unlink()
    print("Checkpoint saved.")
elif sys.argv[1:]:
    raise SystemExit("Usage: python channel-queue.py [--commit]")
else:
    data = json.loads(Path("channel.json").read_text(encoding="utf-8"))
    if data.get("status") != "done":
        raise SystemExit("Channel query did not complete.")
    ids = dict.fromkeys(video.get("videoId", "") for video in
                        (data.get("results") or [{}])[0].get("videos", []))
    new = [value for value in ids if re.fullmatch(r"[A-Za-z0-9_-]{11}", value)
           and value not in processed]
    if queue.exists() and json.loads(queue.read_text()) != new:
        raise SystemExit("Finish the existing queue before replacing it.")
    queue.write_text(json.dumps(new, indent=2), encoding="utf-8")
    print(json.dumps(new, indent=2))
→ proses → commit
python channel-queue.py
# Process every ID in new-ids.json and save its result first.
python channel-queue.py --commit

Mulai pemeriksaan saluran segar sengaja

Pemberi pertanyaan menggunakan kembali jawaban yang disimpan. Untuk pemeriksaan berjadwal berikutnya, gunakan nama file hasil baru, periksa, kemudian salin yang selesai menanggapi channel.json untuk langkah antrian. Tetap jaga processed-ids.json antara berjalan. Daftar terbaru ini bukanlah ekspor saluran penuh atau aliran acara.

Periksa · selanjutnya pilih nama berkas baru
python query.py channel-request.json channel-next.json
Setelah konfirmasi status selesai
python -c "from shutil import copyfile; copyfile('channel-next.json', 'channel.json')"

Gunakan saran - saran untuk meningkatkan pertanyaan

Cadang saran kembali frasa dalam hasil[0], bukan catatan video. Melih frasa yang berguna dan buat permintaan youtube_search yang terpisah. Tetapkan bahasa dan wilayah untuk penonton Anda meneliti.

suggestions-request.json
{
  "source": "youtube_suggestions",
  "query": "battery recycling",
  "params": {
    "language": "en",
    "region": "US"
  }
}
Lepaskan sekali dengan query.py
python query.py suggestions-request.json suggestions.json

Label lisensi Toko Kesentoran tanpa memperlakukan mereka sebagai izin

youtube_trainability mengembalikan label lisensi untuk sebuah video. diijinkan: ["all"] maps to Creative Commons; ["none"] juga meliputi data meta lisensi yang hilang. Tetap simpan video ID, respon sumber dan tanggal penerimaan kembali. Nama label ini tidak memberikan download, penggunaan kembali atau hak pelatihan.

license-request.json
{
  "source": "youtube_trainability",
  "video_id": "FUfGcZ092b0"
}
Lepaskan sekali dengan query.py
python query.py license-request.json license.json

Membatasi pekerjaan untuk aplikasi dan agen

KANTORImplementasi yang luar biasa
Kekayaan yang Dipilih sebelum diperkayaUntuk tugas topik: satu pencarian, satu data meta video yang dipilih dan satu trek kapsi yang dipilih. EZOZE Paksakan anggaran panggilan dalam aplikasi Anda, dan harga setiap sumber secara terpisah.
Digunakan kembali oleh masukan sebenarnyaMetadata: video pilihan ID +. Kapsi: video ID + bahasa + trek. Saluran snapshots juga membutuhkan waktu penerimaan atau jalankan ID.
Hentikan bukti yang hilangJangan coba lagi hasil penemuan kosong atau beralih secara diam-diam trek kapsi. Azab kembali jadi pengguna atau workflow dapat memilih tindakan berikutnya.
Simpan penggunaan dan kerja gagalSimpan penggunaan dengan respon yang sukses. 429Q, kehormatan Retry-After; setelah penyerahan yang tidak pasti, periksa History sebelum kueri berbayar lain.