Semak dokumentasi
Panduan
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 Anda | Sumber | Keputusan |
|---|---|---|
| Memerlukan video tentang topik | youtube_search | Mulai dengan lima kandidat, lalu pilih dengan relevansi. |
| Periksalah sebuah video yang dikenal | youtube_metadata | Bahasa wikipedia. |
| Ringkaskan atau petik perkara yang disebut | youtube_transcript / youtube_captions | Pilih bahasa dan trek otomatis atau manual. |
| Periksa unggahan saluran terbaru | youtube_channel | Aquimation 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.
python -m pip install requestsBash. Megantikan REQUEST.json dan RESULT.json dengan nama berkas untuk contoh yang Anda pilih. Periksa hasil sebelum mengulangi permintaan; perintah ini menyelamatkan tubuh HTTP bahkan untuk kesalahan.
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e RESULT.json || { echo 'Read RESULT.json first'; exit 1; }
curl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries/realtime' \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Content-Type: application/json' \
--data-binary @REQUEST.json --output RESULT.json
)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.
# 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# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKeySimpan 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 — 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.
{
"source": "youtube_search",
"query": "battery recycling process explained",
"params": {
"max_results": 5,
"filters": {
"type": "video",
"subtitles": true
}
}
}python query.py discover-request.json search.jsonPilih 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 — 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))python candidates.pyEkspansi 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.
{
"source": "youtube_search_extended",
"query": "battery recycling process explained",
"params": {
"max_results": 50,
"filters": {
"type": "video"
}
}
}python query.py extended-request.json extended.jsonHanya 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.
{
"source": "youtube_metadata",
"video_id": "FUfGcZ092b0",
"params": {
"include_formats": false,
"include_chapters": false
}
}python query.py metadata-request.json metadata.jsonPeriksa 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.
| Pemadapan | Gunalah untuk |
|---|---|
| language | Kode dari transcriptLanguages, seperti en atau zh-Hans. Daftar ini tidak membedakan trek manual dan otomatis. |
| auto: true | Sebuah lintasan yang telah dijana secara otomatis. |
| auto: false | Sebuah trek yang disediakan secara manual. Tidak ada kehancuran di antara dua tipe trek. |
python -m json.tool metadata.jsonTak 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.
{
"source": "youtube_transcript",
"video_id": "FUfGcZ092b0",
"params": {
"language": "en",
"auto": true
}
}python query.py captions-request.json captions.jsonJaga 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.
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)python cite-segments.pyHanya 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.
{
"source": "youtube_channel",
"handle": "@TED",
"params": {
"video_limit": 10
}
}python query.py channel-request.json channel.jsonBuat 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 — 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))python channel-queue.py
# Process every ID in new-ids.json and save its result first.
python channel-queue.py --commitMulai 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.
python query.py channel-request.json channel-next.jsonpython -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.
{
"source": "youtube_suggestions",
"query": "battery recycling",
"params": {
"language": "en",
"region": "US"
}
}python query.py suggestions-request.json suggestions.jsonLabel 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.
{
"source": "youtube_trainability",
"video_id": "FUfGcZ092b0"
}python query.py license-request.json license.jsonMembatasi pekerjaan untuk aplikasi dan agen
| KANTOR | Implementasi yang luar biasa |
|---|---|
| Kekayaan yang Dipilih sebelum diperkaya | Untuk 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 sebenarnya | Metadata: video pilihan ID +. Kapsi: video ID + bahasa + trek. Saluran snapshots juga membutuhkan waktu penerimaan atau jalankan ID. |
| Hentikan bukti yang hilang | Jangan 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 gagal | Simpan penggunaan dengan respon yang sukses. 429Q, kehormatan Retry-After; setelah penyerahan yang tidak pasti, periksa History sebelum kueri berbayar lain. |