Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Contoh

YouTube Search API: panduan Python

Cari YouTube berdasarkan kata kunci, filter video, dan ekspor CSV, JSONL serta ID video tanpa duplikat dengan Python.

Di halaman ini

Mencari YouTube dengan Python

Python SDK
python -m pip install -U flashdata
search.py
from flashdata import FlashData

with FlashData(api_key="your-flashdata-api-key") as client:
    result = client.youtube.search(
        "battery recycling process",
        max_results=5,
        filters={"type": "video"},
    )

for video in result["results"][0]["results"]:
    print(video["title"], video["videoId"])

Respons pencarian nyata

Ini adalah tiga hasil pertama dari 20 hasil demo publik untuk “battery recycling process” pada 15 November 2026. Rekaman menyimpan enam kolom per video. Jalankan demo langsung untuk hasil terbaru.

results[0].results · 3 / 20
[
  {
    "videoId": "s2xrarUWVRQ",
    "title": "What *Really* happens to used Electric Car Batteries? - (you might be surprised)",
    "channel": "JerryRigEverything",
    "duration": 424,
    "viewCount": 5679251,
    "uploadDate": null
  },
  {
    "videoId": "RW0itbw_ALI",
    "title": "Recycling Batteries",
    "channel": "mbmmllc",
    "duration": 193,
    "viewCount": 91440,
    "uploadDate": null
  },
  {
    "videoId": "dyDoOcBMAHw",
    "title": "Why It's So Hard To Recycle Electric-Car Batteries | World Wide Waste",
    "channel": "Business Insider India",
    "duration": 376,
    "viewCount": 880172,
    "uploadDate": null
  }
]

Menggabungkan beberapa pencarian menjadi dataset

Toolkit Python menyimpan respons yang selesai, menghapus ID video duplikat, dan mempertahankan setiap kueri serta posisi hasil yang cocok. Lanjutkan dengan opsi yang sama dan resume=True untuk memakai kembali pencarian yang selesai.

Python toolkit
python -m pip install "https://github.com/flashdatadev/youtube-search-api/releases/download/v0.1.0/flashdata_youtube_search_api-0.1.0-py3-none-any.whl"
search_to_dataset.py
from flashdata_search import SearchClient, collect

with SearchClient(api_key="your-flashdata-api-key") as client:
    summary = collect(
        client,
        ["battery recycling process", "lithium battery recycling plant"],
        "output/batteries",
        max_results=20,
        filters={"duration": "4-20", "subtitles": True},
    )

print(summary["unique_videos"], "unique videos")
# output/batteries: videos.csv, videos.jsonl, video-ids.txt, summary.json

Pencarian standar atau diperluas?

Pencarian standar menerima 1–20 hasil per kueri. Pencarian diperluas menerima 1–700 dengan tarif terpisah. Keduanya memakai 20 secara default; max_results adalah batas, bukan jumlah hasil yang dijamin.

Gunakan filter durasi, tanggal unggah, urutan, dan subtitel. Endpoint ini tidak menyediakan nomor halaman atau token kelanjutan. Gunakan pencarian diperluas untuk lebih banyak hasil.

Mengambil lebih banyak hasil dengan pencarian diperluas
from flashdata import FlashData

with FlashData(api_key="your-flashdata-api-key") as client:
    result = client.youtube.search_extended(
        "battery recycling process",
        max_results=100,
        filters={"type": "video", "duration": "4-20"},
    )

print(len(result["results"][0]["results"]), "returned results")

Persempit pencarian ketika dibutuhkan

filters
from flashdata import FlashData

with FlashData(api_key="your-flashdata-api-key") as client:
    result = client.youtube.search(
        "battery recycling process",
        max_results=20,
        filters={
            "type": "video",
            "duration": "4-20",
            "subtitles": True,
            "sort_by": "view_count",
        },
    )

Pilih apa yang akan diperkaya selanjutnya

Gunakan video-ids.txt sebagai masukan untuk metadata, transkrip, atau unduhan massal. Tinjau video kandidat sebelum memilih ID untuk diperkaya atau dikirim.

Tugas berikutnyaGunakan IDs terpilih untuk
Periksa rincian videoAmbil metadata untuk ID terpilih. Inspeksi transcriptLanguages sebelum meminta trek judul tertentu.
Rangkuman isi yang diucapkanBaca transkrip yang tersedia atau judul trek dan penanda waktu mengutip. Jangan merangkum video dari deskripsi pencariannya saja.
Kembangkan beberapa videoGunakan selected-video-ids.txt sebagai masukan ke panduan pengayaan. Metadata dan takarir adalah permintaan terpisah dengan izin dan biaya mereka sendiri.

Contoh REST lengkap dengan respons tersimpan

Opsional: gunakan requests atau cURL secara langsung. Simpan request.json di samping skrip. Isi kunci API pada variabel key di Python; Bash membaca FLASHDATA_API_KEY atau meminta kunci. Setiap folder keluaran baru mengirim satu pencarian.

Jalankan dengan search-001 sebagai folder keluaran. Folder baru menyerahkan satu pencarian yang dapat ditagih; folder yang ada dibaca secara lokal. Skrip menyimpan permintaan, respon, dan penggunaan yang tepat.

youtube-search/request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video"
    }
  }
}
Pasang di lingkungan Python Anda
python -m pip install requests
youtube-search/search.py
import argparse
import json
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 search")
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_search"
            or not isinstance(request.get("query"), str) or not request["query"].strip()):
        raise SystemExit("request.json must contain youtube_search and a nonempty query")
    key = "your-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")
data = json.loads((out / "result.json").read_bytes())
if not isinstance(data, dict) or data.get("source") != "youtube_search" or data.get("status") != "done":
    raise SystemExit("Search did not finish successfully; inspect result.json")
pages = data.get("results")
if not isinstance(pages, list) or any(
    not isinstance(page, dict) or not isinstance(page.get("results"), list) for page in pages
):
    raise SystemExit("Expected results[].results arrays; inspect result.json")

videos, seen, skipped, duplicates = [], set(), 0, 0
for page in pages:
    for row in page["results"]:
        if not isinstance(row, dict):
            raise SystemExit("Expected video result objects; inspect result.json")
        video_id = row.get("videoId")
        if not isinstance(video_id, str) or not re.fullmatch(r"[A-Za-z0-9_-]{11}", video_id):
            skipped += 1
        elif video_id in seen:
            duplicates += 1
        else:
            seen.add(video_id)
            videos.append({**row, "url": "https://www.youtube.com/watch?v=" + video_id})
record = {
    "request": json.loads((out / "request.json").read_bytes()),
    "requested_at": (out / "requested-at.txt").read_text().strip(),
    "usage": data.get("usage"), "video_count": len(videos),
    "skipped_items": skipped, "duplicates_removed": duplicates, "result_file": "result.json",
}
for filename, value in (("videos.json", videos), ("record.json", record)):
    (out / filename).write_text(json.dumps(value, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
(out / "video-ids.txt").write_text("".join(v["videoId"] + "\n" for v in videos), encoding="utf-8")
print(f"Saved {len(videos)} videos to {out}/videos.json and video-ids.txt")
Jalankan dari youtube-cari /
python search.py search-001

Jika pencarian membutuhkan perhatian

Apa yang terjadi?Yang perlu dilakukan
Kurang dari lima video, atau tidak adaIni bisa menjadi pencarian yang sukses. Ajukan permintaan atau hapus penyaring pembatasan. totalResults menjelaskan respon ini, bukan jumlah yang cocok dengan video YouTube.
401 / 403 / 402Periksa kunci, youtube_search izin dan keseimbangan, secara terhormat. Perbaiki penyebabnya sebelum membuat usaha baru.
429Untuk HTTP 429, tunggu sesuai Retry-After. Toolkit hanya mengulang respons 429 yang eksplisit, maksimal dua kali secara default, dan berhenti jika penundaan melebihi 60 detik. Contoh SDK langsung dan REST tidak mengulang otomatis.
Waktu habis, 5xx atau folder tidak lengkapSimpan berkas dan periksa riwayat konsol sebelum mengirim lagi. Toolkit tidak mengirim ulang otomatis permintaan yang hasilnya belum diketahui.