Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Приклади

YouTube Search API: посібник Python

Шукайте відео на YouTube за ключовими словами, застосовуйте фільтри й експортуйте CSV, JSONL та ID відео без дублікатів за допомогою Python.

На цій сторінці

Пошук на YouTube з 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"])

Справжня відповідь пошуку

Це перші три з 20 результатів публічної демонстрації за запитом «battery recycling process» від 15 листопада 2026 року. Запис містить шість полів на відео. Запустіть живу демонстрацію для актуальних результатів.

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

Об’єднання кількох пошуків у набір даних

Набір інструментів Python зберігає завершені відповіді, видаляє повторні ID та зберігає кожен запит і позицію збігу. Продовжте з тими самими параметрами та resume=True, щоб використати вже виконані пошуки.

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

Звичайний чи розширений пошук?

Звичайний пошук приймає 1–20 результатів на запит. Розширений — 1–700 за окремим тарифом. Типове значення для обох — 20; max_results є межею, а не гарантованою кількістю.

Фільтруйте за тривалістю, датою завантаження, сортуванням і субтитрами. Ці ендпоїнти не надають номера сторінки чи токена продовження. Для більшої кількості результатів використовуйте розширений пошук.

Більше результатів із розширеним пошуком
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")

Вузький пошук при необхідності

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

Виберіть те, що збагачувати наступний

Використовуйте video-ids.txt для метаданих, транскриптів або масового завантаження. Перевірте відео перед вибором ID для збагачення чи доставки.

Ваше наступне завданняВикористовуйте вибраний IDs для
Перевірити деталі відеоЗахоплення метаданих для вибраного ID. Огляньте transcriptLanguages перед запитом на конкретну доріжку підписки.
Summarize спійманий вмістПрочитайте наявну трафаретну або підписну доріжок і цитуйте часові запаси. Не підсумуйте відео з опису його пошуку окремо.
Збагатити кілька відеоВикористовуйте selected-video-ids.txt як вхід до керівництва збагачення. Метадані та підписи є окремими запитами з власними дозволами та зарядами.

Повний приклад REST зі збереженням відповідей

За бажанням використовуйте requests або cURL напряму. Збережіть request.json поруч зі скриптом. Укажіть API-ключ у змінній key у Python; Bash читає FLASHDATA_API_KEY або запитує ключ. Кожна нова папка виводу надсилає один пошук.

Запустіть з пошуково-001 як папка виходу. Нова папка подає один вексельний пошук; існуючу папку читайте локально. Скрипт зберігає точний поданий запит, відповідь та використання.

youtube-search/request.json
{
  "source": "youtube_search",
  "query": "battery recycling process explained",
  "params": {
    "max_results": 5,
    "filters": {
      "type": "video"
    }
  }
}
Встановити в середовищі 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")
Запуск з YouTube-догляду/
python search.py search-001

Якщо необхідно звернути увагу на пошук

Що відбулосяЩо робити
Февертер, ніж п'ять відео, або ніЦе може бути успішним пошуком. Відновити запит або видалити обмежений фільтр. totalResults описувати цю відповідь, не загальна кількість матчів YouTube відео.
401 / 403 / 402Перевірити ключ, дозвіл youtube_search і баланс відповідно. Виправлення причини перед створенням нової спроби.
429Для HTTP 429 дотримуйтеся Retry-After. Інструмент повторює лише явні відповіді 429, типово не більш ніж двічі, та зупиняється, якщо очікування перевищує 60 секунд. Прямі приклади SDK та REST не повторюють запити автоматично.
Час, 5xxx або неповна папкаЗбережіть файли й перевірте історію консолі перед повторним надсиланням. Інструмент не надсилає автоматично запити з невідомим результатом.