Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Przykłady

YouTube Search API: poradnik Python

Wyszukuj w YouTube według słów kluczowych, filtruj filmy i eksportuj pliki CSV, JSONL oraz identyfikatory bez duplikatów w Pythonie.

Na tej stronie

Wyszukiwanie w YouTube z Pythonem

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

Prawdziwa odpowiedź wyszukiwania

To pierwsze trzy z 20 wyników pobranych w publicznym demo dla „battery recycling process” 15 listopada 2026 r. Zapis zawiera sześć pól na film. Uruchom demo na żywo, aby uzyskać aktualne wyniki.

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

Łączenie wielu wyszukiwań w zbiór danych

Zestaw narzędzi Python zapisuje ukończone odpowiedzi, usuwa powielone ID filmów i zachowuje każde pasujące zapytanie oraz pozycję. Wznów z tymi samymi opcjami i resume=True, aby ponownie użyć ukończonych wyszukiwań.

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

Wyszukiwanie standardowe czy rozszerzone?

Standardowe wyszukiwanie przyjmuje 1–20 wyników na zapytanie. Rozszerzone przyjmuje 1–700 i ma osobną stawkę. Oba domyślnie używają 20; max_results to limit, a nie gwarantowana liczba wyników.

Filtruj według długości, daty przesłania, sortowania i napisów. Te endpointy nie udostępniają numerów stron ani tokenów kontynuacji. Użyj wyszukiwania rozszerzonego, gdy potrzebujesz więcej wyników.

Więcej wyników dzięki wyszukiwaniu rozszerzonemu
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")

Zawężenie wyszukiwania w razie potrzeby

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

Wybierz, co wzbogacić następny

Użyj video-ids.txt jako danych wejściowych do metadanych, transkrypcji lub pobierania zbiorczego. Sprawdź filmy przed wyborem ID do wzbogacenia lub dostarczenia.

Twoje następne zadanieUżyj wybranego IDs dla
Sprawdź szczegóły wideoPobierz metadane dla wybranego ID. Sprawdź transcriptLanguages przed zwróceniem się z prośbą o wybranie konkretnego utworu.
Podsumowanie treści mówionejPrzeczytaj dostępny transkrypt lub napisy i cytuj znaczniki czasu. Nie podsumowuj filmu z jego opisu wyszukiwania.
Ubogać kilka filmówUżywać selected-video-ids.txt jako wejścia do przewodnika wzbogacania. Metadane i podpisy są odrębnymi żądaniami z ich własnymi uprawnieniami i opłatami.

Pełny przykład REST z zapisem odpowiedzi

Opcjonalnie użyj requests lub cURL bezpośrednio. Zapisz request.json obok skryptu. Wpisz klucz API w zmiennej key w Pythonie; Bash czyta FLASHDATA_API_KEY lub prosi o klucz. Każdy nowy katalog wyjściowy wysyła jedno wyszukiwanie.

Uruchom z wyszukiwarką 001 jako folder wyjściowy. Nowy folder przedstawia jeden billable search; istniejący folder jest odczytywany lokalnie. Skrypt zachowuje dokładnie przedstawione żądanie, odpowiedź i użycie.

youtube-search/request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video"
    }
  }
}
Zainstaluj w środowisku Python
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")
Uciekaj od youtube- search /
python search.py search-001

Jeśli wyszukiwanie wymaga uwagi

Co się stało?Co zrobić
Mniej niż pięć filmów, lub żadnychTo może być pomyślne przeszukanie. totalResults opisuje tę odpowiedź, a nie całkowitą liczbę pasujących filmów YouTube.
401 / 403 / 402Sprawdź klucz, odpowiednio pozwolenie youtube_search i saldo. Napraw sprawę przed stworzeniem nowej próby.
429Przy HTTP 429 odczekaj czas z Retry-After. Narzędzie ponawia tylko jawne odpowiedzi 429, domyślnie najwyżej dwa razy, i zatrzymuje się przy oczekiwaniu ponad 60 sekund. Bezpośrednie przykłady SDK i REST nie ponawiają automatycznie.
Czas, 5xx lub niekompletny folderZachowaj pliki i sprawdź historię konsoli przed ponownym wysłaniem. Narzędzie nie wysyła automatycznie ponownie żądań o nieznanym wyniku.