Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Voorbeelden

YouTube Search API: Python-handleiding

Doorzoek YouTube op trefwoord, filter video's en exporteer ontdubbelde CSV-, JSONL- en video-ID-bestanden met Python.

Op deze pagina

YouTube doorzoeken met 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"])

Een echt zoekantwoord

Dit zijn de eerste drie van 20 resultaten uit de openbare demo voor ‘battery recycling process’ op 15 november 2026. De opname bewaart zes velden per video. Gebruik de live demo voor actuele resultaten.

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

Meerdere zoekopdrachten tot een dataset bundelen

De Python-toolkit slaat voltooide antwoorden op, verwijdert dubbele video-ID's en bewaart elke overeenkomende zoekopdracht en positie. Hervat met dezelfde opties en resume=True om voltooide zoekopdrachten te hergebruiken.

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

Standaard of uitgebreid zoeken?

Standaard zoeken accepteert 1–20 resultaten per zoekopdracht. Uitgebreid zoeken accepteert 1–700 tegen een apart tarief. Beide gebruiken standaard 20; max_results is een limiet, geen gegarandeerd aantal.

Filter op duur, uploaddatum, sortering en ondertitels. Deze endpoints bieden geen paginanummer of vervolgtoken. Gebruik uitgebreid zoeken voor meer resultaten.

Meer resultaten ophalen met uitgebreid zoeken
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")

Zoekopdracht verkleinen indien nodig

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

Kies wat je nu moet verrijken

Gebruik video-ids.txt als invoer voor metadata, transcripties of bulkdownloads. Bekijk de kandidaatvideo's voordat je de te verrijken of te leveren ID's selecteert.

Uw volgende taakGebruik de geselecteerde IDs voor
Controleer de details van een videoMetadata ophalen voor een geselecteerde ID. Inspecteer transcriptLanguages voordat u een specifieke titeltrack aanvraagt.
Samengevat gesproken inhoudLees een beschikbare transcript of bijschrift track en citeer tijdstempels. De video uit de zoekbeschrijving alleen niet samenvatten.
Verrijk verschillende video'sGebruik selected-video-ids.txt als input voor de verrijkingsgids. Metadata en bijschriften zijn afzonderlijke verzoeken met hun eigen permissies en kosten.

Volledig REST-voorbeeld met opgeslagen antwoorden

Optioneel: gebruik requests of cURL direct. Sla request.json naast het script op. Zet je API-sleutel in de Python-variabele key; Bash leest FLASHDATA_API_KEY of vraagt erom. Elke nieuwe uitvoermap verstuurt één zoekopdracht.

Uitvoeren met zoek-001 als uitvoermap. Een nieuwe map dient één factureerbare zoekopdracht in; een bestaande map wordt lokaal gelezen. Het script houdt het exacte ingediende verzoek, antwoord en gebruik.

youtube-search/request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video"
    }
  }
}
Installeer in uw Python omgeving
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")
Uitvoeren van youtube-search /
python search.py search-001

Als de zoektocht aandacht nodig heeft

Wat is er gebeurd?Wat je moet doen
Minder dan vijf video's, of geenDit kan een succesvolle zoektocht zijn. Verfijn de query of verwijder een beperkend filter. totalResults beschrijft dit antwoord, niet het totale aantal overeenkomende YouTube video's.
401 / 403 / 402Controleer de sleutel, youtube_search permissie en balans, respectievelijk. Repareer de oorzaak voordat er een nieuwe poging wordt gedaan.
429Wacht bij HTTP 429 volgens Retry-After. De toolkit herhaalt alleen expliciete 429-antwoorden, standaard maximaal twee keer, en stopt bij een wachttijd boven 60 seconden. De directe SDK- en REST-voorbeelden herhalen niet automatisch.
Time-out, 5xx of een onvolledige mapBewaar de bestanden en controleer de consolegeschiedenis voordat je opnieuw indient. De toolkit verstuurt verzoeken met een onbekende uitkomst niet automatisch opnieuw.