İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Örnekler

YouTube Search API: Python rehberi

Python ile YouTube'da anahtar kelimeyle arama yapın, videoları filtreleyin ve yinelenmeyen CSV, JSONL ve video kimliği dosyaları oluşturun.

Bu sayfada

Python ile YouTube'da arama

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"])

Gerçek bir arama yanıtı

Bunlar, 15 Kasım 2026'da herkese açık demoda “battery recycling process” sorgusu için alınan 20 sonucun ilk üçüdür. Kayıt video başına altı alanı korur. Güncel sonuçlar için canlı demoyu çalıştırın.

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
  }
]

Birden fazla aramayı veri kümesinde toplama

Python araç seti tamamlanan yanıtları kaydeder, yinelenen video kimliklerini kaldırır ve eşleşen her sorguyu ve sonuç sırasını korur. Tamamlanan aramaları yeniden kullanmak için aynı seçeneklerle ve resume=True ile devam edin.

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

Standart mı, genişletilmiş arama mı?

Standart arama sorgu başına 1–20 sonuç kabul eder. Genişletilmiş arama ayrı bir ücretle 1–700 kabul eder. İkisinin de varsayılanı 20'dir; max_results bir sınırdır, sonuç sayısı garantisi değildir.

Süre, yükleme tarihi, sıralama ve altyazı filtrelerini kullanın. Bu uç noktalar sayfa numarası veya devam belirteci sunmaz. Daha fazla sonuç için genişletilmiş aramayı kullanın.

Genişletilmiş aramayla daha fazla sonuç alma
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")

Narrow the search when needed

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",
        },
    )

Bir sonraki zenginliğe neyin zenginleştirilmesini seçin

video-ids.txt dosyasını meta veri, transkript veya toplu indirme iş akışlarına girdi olarak kullanın. Zenginleştirilecek veya teslim edilecek kimlikleri seçmeden önce aday videoları inceleyin.

Bir sonraki görevinizSeçilen IDs'u kullanın
Bir videonun ayrıntılarını kontrol edinseçilmiş bir ID için Fetch metadata. Inspect transcriptLanguages, belirli bir satır izi talep etmeden önce.
Summarize konuşma içeriğiMevcut bir transkript veya satır izi okuyun ve zamanları ayırın. Videoyu yalnızca arama açıklamasından özetlemeyin.
En zengin birkaç videoselected-video-ids.txt'u zenginleştirme kılavuzuna giriş olarak kullanın. Metadata ve kuyruklar kendi izni ve suçlamaları ile ayrı taleplerdir.

Yanıtları kaydeden tam REST örneği

İsteğe bağlı olarak requests veya cURL'ü doğrudan kullanın. request.json dosyasını betiğin yanına kaydedin. API anahtarını Python'daki key değişkenine yazın; Bash, FLASHDATA_API_KEY değerini okur veya anahtarı sorar. Her yeni çıktı klasörü bir arama gönderir.

Arama-001 ile çıktı klasörü olarak çalıştırın. Yeni bir klasör bir faturalanabilir arama sunar; mevcut bir klasör yerel olarak okunur. Senaryo tam olarak sunulan istek, yanıt ve kullanım tutar.

youtube-search/request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video"
    }
  }
}
Python ortamınıza yükleme
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")
youtube-search / Run from youtube-search /
python search.py search-001

Aramanın dikkatine ihtiyacı varsa

Ne oldu?Yapılacak işlem
Beş videodan daha az, ya da hiçbiriBu başarılı bir arama olabilir. Soruyu reddetmek veya kısıtlayıcı bir filtre kaldırmak. totalResults bu cevabı açıklar, YouTube videolarının toplam sayısı değil.
401 / 403 / 402Anahtarı kontrol edin, youtube_search izin ve denge, sırasıyla. Yeni bir girişim yaratmadan önce nedeni düzeltin.
429HTTP 429 için Retry-After süresini bekleyin. Araç seti yalnızca açık 429 yanıtlarını varsayılan olarak en fazla iki kez yeniden dener ve bekleme 60 saniyeyi aşarsa durur. Doğrudan SDK ve REST örnekleri otomatik yeniden deneme yapmaz.
Timeout, 5xx veya eksik bir klasörDosyaları koruyun ve yeniden göndermeden önce konsol geçmişini kontrol edin. Araç seti sonucu bilinmeyen istekleri otomatik olarak yeniden göndermez.