# FlashData YouTube 拡張検索 API

リクエストごとの700 YouTubeの検索結果、ビデオの詳細、サムネイル、検索フィルタなどを取得します。

キャニシニカル参照: https://flashdata.dev/ja/docs/sources/youtube_search_extended
レビュー: 2026-11-16

エンドポイント: POST https://data.flashdata.dev/v1/queries/realtime
認証: X-API-Key: YOUR_API_KEY
モード: [Realtime](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ja/docs/reference/batch-and-bulk/reference.md#batch)

必要なソース権限: youtube_search_extended

YOUR_API_KEYをAPIキーに置き換え、このソースの許可と利用可能なクレジットを持っています。 サーバやエージェントホストのリクエストを実行します。

[認証の設定](https://flashdata.dev/ja/docs/guides/headers-and-authentication/reference.md)

[より大きな候補検索を計画する](https://flashdata.dev/ja/docs/guides/youtube-data-guide/reference.md#extended)

<a id="quickstart"></a>

## リクエストを送信

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_search_extended",
    "query": "python",
    "params": {
        "max_results": 20,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "youtube_search_extended",
  "query": "python",
  "params": {
    "max_results": 20
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## パラメーター

<a id="parameters-group-0"></a>

### リクエストボディ

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | はい はい | — | youtube_search_extendedに設定します。  |
| <a id="parameter-query"></a> query | string | はい はい | 設定なし | クエリを検索します。 最少の長さ: 1。 最高長さ: 2000。 |
| <a id="parameter-params"></a> params | object | ノーザン | {} | この要求のためのSettings。  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | ノーザン | 設定なし | Asyncとバッチだけ。 パブリック HTTPS エントリーフォーム URL 港に 443まで、 2,048 文字。 ユーザーの資格情報や URL フラグメントはありません。 Omit は、通知なしの null または空の文字列を使用します。 バッチでは、各クエリで、外部のパラメータで設定します。  |

<a id="parameters-group-1"></a>

### 結果のカウント

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | ノーザン | 20 | リクエストされた結果のカウント。 フェアーターの結果は、利用可能な場合があります。 最小: 1。 最高: 700。 |

<a id="parameters-group-2"></a>

### フィルターを検索

| パラメータ | 種類 | 必須 | 既定値 | 説明: |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | ノーザン | 設定なし | オプションのアップロード日付、結果タイプ、期間、ソートおよび機能フィルタ。 フィルタなしのnullを省略または使用。 文書化されたフィールドのみが受け入れられます。 |
| <a id="parameter-params-filters-upload_date"></a> params.filters.upload_date | string | ノーザン | 設定なし | アップロード日付でフィルタリングします。 許可される: "today"、"last_hour"、"this_week"、"this_month"、"this_year"。 最少の長さ: 1。 最高長さ: 2000。 |
| <a id="parameter-params-filters-type"></a> params.filters.type | string | ノーザン | 設定なし | 結果型でフィルタリングします。 許可される: "video"、"channel"、"playlist"、"movie"。 最少の長さ: 1。 最高長さ: 2000。 |
| <a id="parameter-params-filters-duration"></a> params.filters.duration | string | ノーザン | 設定なし | 数分でビデオの長さでフィルタリングします。 許可される: "<4"、"4-20"、">20"。 最少の長さ: 1。 最高長さ: 2000。 |
| <a id="parameter-params-filters-sort_by"></a> params.filters.sort_by | string | ノーザン | 設定なし | 結果の注文。 Omit は、YouTube のデフォルト注文を使用する。 許可される: "rating"、"relevance"、"view_count"、"upload_date"。 最少の長さ: 1。 最高長さ: 2000。 |
| <a id="parameter-params-filters-360"></a> params.filters.360 | boolean | ノーザン | 設定なし | true をセットして、360 機能が必要です。  |
| <a id="parameter-params-filters-3d"></a> params.filters.3d | boolean | ノーザン | 設定なし | trueを3dの機能を要求するために置きます。  |
| <a id="parameter-params-filters-4k"></a> params.filters.4k | boolean | ノーザン | 設定なし | trueを4kの機能を要求するために置きます。  |
| <a id="parameter-params-filters-creative_commons"></a> params.filters.creative_commons | boolean | ノーザン | 設定なし | true をセットして、クリエイティブな共通機能を要求します。  |
| <a id="parameter-params-filters-hd"></a> params.filters.hd | boolean | ノーザン | 設定なし | hd 機能を必要とする true を設定します。  |
| <a id="parameter-params-filters-hdr"></a> params.filters.hdr | boolean | ノーザン | 設定なし | true を設定し、HDr 機能が必要です。  |
| <a id="parameter-params-filters-live"></a> params.filters.live | boolean | ノーザン | 設定なし | trueをセットしてライブ機能が必要です。  |
| <a id="parameter-params-filters-location"></a> params.filters.location | boolean | ノーザン | 設定なし | true を設定し、位置情報を必要とする。  |
| <a id="parameter-params-filters-purchased"></a> params.filters.purchased | boolean | ノーザン | 設定なし | trueをセットして、購入した機能が必要です。  |
| <a id="parameter-params-filters-subtitles"></a> params.filters.subtitles | boolean | ノーザン | 設定なし | true を設定し、字幕機能が必要です。  |
| <a id="parameter-params-filters-vr180"></a> params.filters.vr180 | boolean | ノーザン | 設定なし | true を vr180 機能を必要とするように設定します。  |

<a id="response"></a>

## 結果を読む

response.jsonとして成功するJSON応答を保存します。 これをread-response.pyとして保存し、python read-response.pyを実行します。 Pythonの標準ライブラリのみを使用し、新しいリクエストは使用しません。

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"videoId": item.get("videoId"), "title": item.get("title"), "channel": item.get("channel")}
    for item in result.get("results", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## レスポンスの例

記録された例; フィールドとカウントは、ソースと要求された入力に依存します。
```json
{
  "source": "youtube_search_extended",
  "status": "done",
  "results": [
    {
      "results": [
        {
          "videoId": "K5KVEU3aaeQ",
          "title": "Python Full Course for Beginners",
          "channel": "Programming with Mosh",
          "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
          "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
          "duration": 7341,
          "durationString": "2:02:21",
          "viewCount": 7565956,
          "uploadDate": null,
          "description": "Master Python from scratch No fluff—just clear, practical coding skills to kickstart your journey! Want to dive deeper? - Check ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/K5KVEU3aaeQ/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAXbPvWkQhvRSOYWD6mp9EVbfWSYg",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/K5KVEU3aaeQ/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAbeaIhlZJzT49VmWFTFrL3rCq--Q",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "kqtD5dpn9C8",
          "title": "Python for Beginners - Learn Coding with Python in 1 Hour",
          "channel": "Programming with Mosh",
          "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
          "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
          "duration": 3606,
          "durationString": "1:00:06",
          "viewCount": 25317327,
          "uploadDate": null,
          "description": "Learn Python basics in just 1 hour! Perfect for beginners interested in AI and coding. ⚡ Plus, get 6 months of PyCharm FREE with ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/kqtD5dpn9C8/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD1iLVjsmE_gK2uZS887LgyThzx4Q",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/kqtD5dpn9C8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDoYD4sT1l-1w5fEUQt6pdtsKdfLQ",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "_uQrJ0TkZlc",
          "title": "Python Full Course for Beginners",
          "channel": "Programming with Mosh",
          "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
          "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
          "duration": 22447,
          "durationString": "6:14:07",
          "viewCount": 49011589,
          "uploadDate": null,
          "description": "Learn Python for AI, machine learning, and web development with this beginner-friendly course! Get 6 months of PyCharm ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/_uQrJ0TkZlc/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCQfkbApoaN-_QBOuiyHzWJOiziEA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/_uQrJ0TkZlc/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCpUFKfUMVNbg8mqTcZ8UdSUjpilw",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "ix9cRaBkVe0",
          "title": "Python Full Course for free 🐍",
          "channel": "Bro Code",
          "channelId": "UC4SVo0Ue36XCfOyb5Lh1viQ",
          "channelUrl": "https://www.youtube.com/channel/UC4SVo0Ue36XCfOyb5Lh1viQ",
          "duration": 43200,
          "durationString": "12:00:00",
          "viewCount": 12232736,
          "uploadDate": null,
          "description": "python #tutorial #beginners Python tutorial for beginners' full course 2024 *Learn Python in 1 HOUR* ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/ix9cRaBkVe0/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDxOlqOI0ajJHiDKDJKd2mEyl6o8Q",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/ix9cRaBkVe0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAOFhprL8-MOLlhL-mAmfQX14h3JA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PLNcg_FV9n7qZGfFl2ANI_zISzNp257Lwn",
          "title": "Python Ultimate Course",
          "channel": "Data with Baraa",
          "channelId": "UC8_RSKwbU1OmZWNEoLV1tQg",
          "channelUrl": "https://www.youtube.com/channel/UC8_RSKwbU1OmZWNEoLV1tQg",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD0DGP1Fz2uVeT1N4KayechjJWXQQ",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC8xiDHYd35tCqjtIe7zAdNiJV-TQ",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "ygXn5nV5qFc",
          "title": "Python for AI - Full Beginner Course",
          "channel": "Dave Ebbelaar",
          "channelId": "UCn8ujwUInbJkBhffxqAPBVQ",
          "channelUrl": "https://www.youtube.com/channel/UCn8ujwUInbJkBhffxqAPBVQ",
          "duration": 18931,
          "durationString": "5:15:31",
          "viewCount": 1526371,
          "uploadDate": null,
          "description": "Learn Python from scratch and start building real AI applications. This is the fastest, beginner-friendly course Python for AI ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/ygXn5nV5qFc/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAWOQBeND4JW5j_bzYI-BmsTplkfQ",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/ygXn5nV5qFc/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBYZK-1TMdAyhLC18-i_BcFkw1TBA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "9Hku_7e-JSk",
          "title": "3小时超快速入门Python | 动画教学【2025新版】【自学Python教程】【零基础Python】",
          "channel": "林粒粒呀",
          "channelId": "UCpHMIMmvmBTfr-IefM2mu3A",
          "channelUrl": "https://www.youtube.com/channel/UCpHMIMmvmBTfr-IefM2mu3A",
          "duration": 11459,
          "durationString": "3:10:59",
          "viewCount": 379257,
          "uploadDate": null,
          "description": "把Python教程做成动画片了，教学通俗易懂2025最新版，学完入门编程～ 如果你需要进阶学习Python，欢迎了解更多我制作的 ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/9Hku_7e-JSk/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAQyFmKTug_SY679Uy6_D5TvsipfA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/9Hku_7e-JSk/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDkae8uL5ujOK-rzpcNGOt030lhPA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "nLRL_NcnK-4",
          "title": "Harvard CS50’s Introduction to Programming with Python – Full University Course",
          "channel": "freeCodeCamp.org and CS50",
          "channelId": null,
          "channelUrl": null,
          "duration": 57468,
          "durationString": "15:57:48",
          "viewCount": 9040599,
          "uploadDate": null,
          "description": "Learn Python programming from Harvard University. It dives more deeply into the design and implementation of web apps with ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/nLRL_NcnK-4/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAJas_Ng-a8m7MaZy4pFXEtg32wrg",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/nLRL_NcnK-4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA5lx7Ejw4EXmM_Vlc1_bZ3RLKQ7g",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "Rq5gJVxz55Q",
          "title": "Python Full Course for Beginners (13 Hours) – From Zero to Hero",
          "channel": "Data with Baraa",
          "channelId": "UC8_RSKwbU1OmZWNEoLV1tQg",
          "channelUrl": "https://www.youtube.com/channel/UC8_RSKwbU1OmZWNEoLV1tQg",
          "duration": 46973,
          "durationString": "13:02:53",
          "viewCount": 1060826,
          "uploadDate": null,
          "description": "Learn Python from scratch in this complete 13-hour course designed for beginners who want to build real programming ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAuu4tzXeRYigoVzfQEk-yj5Cxpqg",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/Rq5gJVxz55Q/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBPqpz9uFFxOdUMDarDkzaSL2_KRQ",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "wUSDVGivd-8",
          "title": "Python for Data Analytics - Full Course for Beginners",
          "channel": "Luke Barousse",
          "channelId": "UCLLw7jmFsvfIVaUFsLs8mlQ",
          "channelUrl": "https://www.youtube.com/channel/UCLLw7jmFsvfIVaUFsLs8mlQ",
          "duration": 40181,
          "durationString": "11:09:41",
          "viewCount": 1549508,
          "uploadDate": null,
          "description": "FREE Course Files & Project https://lukeb.co/python_repo Supporter Access: Problems, Certificate, & More ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/wUSDVGivd-8/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA85GvFR4YuxTeBj67gS7sT8KkPug",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/wUSDVGivd-8/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB8qopEPMx651G_KsmN1CSWxlDeIQ",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PL-osiE80TeTt2d9bfVyTiXJA-UTHn6WwU",
          "title": "Python Tutorials",
          "channel": "Corey Schafer",
          "channelId": "UCCezIgC97PvUuR4_gbFUs5g",
          "channelUrl": "https://www.youtube.com/channel/UCCezIgC97PvUuR4_gbFUs5g",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/YYXdXT2l-Gg/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC5xC1ZF2J_u3-jTNz_q31gOoerkw",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/YYXdXT2l-Gg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB62tKrSiLOsKgSqTEWX05gsbf03g",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PLsyeobzWxl7poL9JTVyndKe62ieoN-MZ3",
          "title": "Python for Beginners (Full Course) | Programming Tutorial",
          "channel": "Telusko",
          "channelId": "UC59K-uG2A5ogwIrHw4bmlEg",
          "channelUrl": "https://www.youtube.com/channel/UC59K-uG2A5ogwIrHw4bmlEg",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/QXeEoD0pB3E/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCWPAZkJp7z57q2H_k4GCVXz5DUFw",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/QXeEoD0pB3E/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB0rOknPZGuoCIf-6EgHKR1A6TxTA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PLsyeobzWxl7omDoEYrrf3oXvXxa6MPgek",
          "title": "Python Tutorial 2026 | Complete Python Course (Beginner to Advanced) | Telusko",
          "channel": "Telusko",
          "channelId": "UC59K-uG2A5ogwIrHw4bmlEg",
          "channelUrl": "https://www.youtube.com/channel/UC59K-uG2A5ogwIrHw4bmlEg",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/YZkyL-f-YXY/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBd7YDpnC51Ceyhi7EkLd0UnfPc9w",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/YZkyL-f-YXY/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLDqwreruXZFgiuPOpWxK28x1IQUMQ",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "6GuyMZ-cSzE",
          "title": "Python Tutorial for AI: Everything You Need in 2 Hours",
          "channel": "codebasics",
          "channelId": "UCh9nVJoWXmFb7sLApWGcLPQ",
          "channelUrl": "https://www.youtube.com/channel/UCh9nVJoWXmFb7sLApWGcLPQ",
          "duration": 7373,
          "durationString": "2:02:53",
          "viewCount": 196330,
          "uploadDate": null,
          "description": "This Python mini-course is built by keeping in mind the use case of AI. Any AI aspirant who wants to learn AI using Python or want ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/6GuyMZ-cSzE/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCKgWxeLOO6aMMqu89Wsax4Ccu85g",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/6GuyMZ-cSzE/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDV9Hi0PoMSxKSGNDSd4Io7JMiH-w",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "rfscVS0vtbw",
          "title": "Learn Python - Full Course for Beginners [Tutorial]",
          "channel": "freeCodeCamp.org",
          "channelId": "UC8butISFwT-Wl7EV0hUK0BQ",
          "channelUrl": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",
          "duration": 16012,
          "durationString": "4:26:52",
          "viewCount": 49285279,
          "uploadDate": null,
          "description": "This course will give you a full introduction into all of the core concepts in python. Follow along with the videos and you'll be a ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/rfscVS0vtbw/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLD-9-7sK2ChwTaU2oDci15jO7wEDg",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/rfscVS0vtbw/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLABBQtpk83-Gm8-IgPAiGlTtrLH9w",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "xAcTmDO6NTI",
          "title": "Lecture 1: Introduction to CS and Programming Using Python",
          "channel": "MIT OpenCourseWare",
          "channelId": "UCEBb1b_L6zDS3xTUrIALZOw",
          "channelUrl": "https://www.youtube.com/channel/UCEBb1b_L6zDS3xTUrIALZOw",
          "duration": 3810,
          "durationString": "1:03:30",
          "viewCount": 2296795,
          "uploadDate": null,
          "description": "MIT 6.100L Introduction to CS and Programming using Python, Fall 2022 Instructor: Ana Bell View the complete course: ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/xAcTmDO6NTI/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDZ5a1dBlEdpB7Xmrvg164lDqjy1Q",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/xAcTmDO6NTI/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBQapxSAyS3sQq1FtatNJ0ja36MFA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PLdo5W4Nhv31bZSiqiOL5ta39vSnBxpOPT",
          "title": "Python Full Course",
          "channel": "Jenny's Lectures CS IT",
          "channelId": "UCM-yUTYGmrNvKOCcAl21g3w",
          "channelUrl": "https://www.youtube.com/channel/UCM-yUTYGmrNvKOCcAl21g3w",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/6i3EGqOBRiU/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLA8vm9XyKYbEzPwshASn00OZzfvBw",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/6i3EGqOBRiU/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCuzoXzg904azzFqkMR6VN_9vPdjA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "b093aqAZiPU",
          "title": "👩‍💻 Python for Beginners Tutorial",
          "channel": "Kevin Stratvert",
          "channelId": "UCfJT_eYDTmDE-ovKaxVE1ig",
          "channelUrl": "https://www.youtube.com/channel/UCfJT_eYDTmDE-ovKaxVE1ig",
          "duration": 3801,
          "durationString": "1:03:21",
          "viewCount": 4592374,
          "uploadDate": null,
          "description": "In this step-by-step Python for beginner's tutorial, learn how you can get started programming in Python. In this video, I assume ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/b093aqAZiPU/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBMc52n3VeviTzlhsRCemDDz8l1Ow",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/b093aqAZiPU/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBG6MYAXELGegdhLlZJPKwwLierDA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "Y8Tko2YC5hA",
          "title": "What is Python? Why Python is So Popular?",
          "channel": "Programming with Mosh",
          "channelId": "UCWv7vMbMWH4-V0ZXdmDpPBA",
          "channelUrl": "https://www.youtube.com/channel/UCWv7vMbMWH4-V0ZXdmDpPBA",
          "duration": 247,
          "durationString": "4:07",
          "viewCount": 2341508,
          "uploadDate": null,
          "description": "What is Python? This short video explains it in 4 minutes. Python Tutorial for Beginners: https://youtu.be/_uQrJ0TkZlc Python ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/Y8Tko2YC5hA/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLC9k_U_x1CBmU1p1YwHz-TTyPBLpg",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/Y8Tko2YC5hA/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAHduruMh6QwyHhLnNsE9WwQSQjxg",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "VchuKL44s6E",
          "title": "Python As Fast as Possible - Learn Python in ~75 Minutes",
          "channel": "Tech With Tim",
          "channelId": "UC4JX40jDee_tINbkjycV4Sg",
          "channelUrl": "https://www.youtube.com/channel/UC4JX40jDee_tINbkjycV4Sg",
          "duration": 4781,
          "durationString": "1:19:41",
          "viewCount": 2255229,
          "uploadDate": null,
          "description": "GET MY FREE SOFTWARE DEVELOPMENT GUIDE   https://training.techwithtim.net/free-guide This python tutorial aims to teach ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/VchuKL44s6E/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB6udnq8elg0jaxG5wKibJxNCLkPA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/VchuKL44s6E/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB5Ob2qlI0bsygtt2fHQlnsF7yiaQ",
              "width": 720,
              "height": 404
            }
          ]
        }
      ],
      "totalResults": 20,
      "query": "python"
    }
  ],
  "usage": {
    "credits": 0.05
  },
  "created_at": "2026-09-16T07:41:46.808Z"
}
```

## 応答分野

| フィールド | 種類 | 説明: |
| --- | --- | --- |
| source | string | 要求されたAPIの源。 |
| status | string | リアルタイムリクエストが成功したときに行われる。 |
| created_at | string | ISO 8601 形式の応答作成時間。 |
| usage.credits | number | リクエストに応じて請求されるクレジットは、プランに基づいて行われます。 |
| results[0].query | string | 検索クエリ。 |
| results[0].totalResults | integer | 返された結果の数。 |
| results[0].results | array | 返された注文で結果を検索します。 |
| results[0].results[].videoId | string | YouTubeビデオID。 |
| results[0].results[].title | string | ビデオタイトル。 |
| results[0].results[].channel | string | チャンネル名。 |
| results[0].results[].channelId | string · nullable | IDを利用できるときチャネル。 |
| results[0].results[].channelUrl | string · nullable | URLを利用できるときチャネル。 |
| results[0].results[].duration | number · nullable | 秒単位のビデオ持続時間。 |
| results[0].results[].durationString | string · nullable | 利用可能な場合、ビデオの長さをフォーマットしました。 |
| results[0].results[].viewCount | number · nullable | 利用可能な場合のカウントを表示します。 |
| results[0].results[].uploadDate | string · nullable | 利用可能な日付をアップロードします。 |
| results[0].results[].description | string · nullable | 説明は、500文字、またはnull文字まで、利用できなくなったときに有効です。 |
| results[0].results[].thumbnails | array | サムネイルURLsと寸法。 |

- 20 結果の検索 API のデフォルト。 拡張検索は、700 までの max_results を受け入れ、別の使用率を持っています。

## レスポンス形式

応答はデフォルトでJSONを使用します。 これらのオプションヘッダーで別の形式を選択します。

- Accept: application/json (デフォルト) または text/plain. プレーンテキストは、読みやすいレイアウトで同じフィールドを提示します。
- X-Respond-With: markdown. 元のフィールドにアンセットを残します。 Markdownは、応答形式のいずれかで動作します。

Markdownはリアルタイムの問い合わせと完了した結果に利用できます。

下のフィールドは、デフォルトのJSON応答を記述します。

[リクエストとレスポンスの形式例](https://flashdata.dev/ja/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## API の基本

上記のビルダーと例は、このソースのパラメーターを使用します。 Python と cURL の例を以下に使用して、共有の投稿、ステータス、結果の手順を実行します。 Batch ボディは、クエリを含む JSON オブジェクトです。各項目は独自のジョブ ID を返します。

- [Asyncリクエストとレシート](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [ジョブステータスの確認](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#status)

<a id="job-results"></a>

- [完了した結果を取得する](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON リクエスト](https://flashdata.dev/ja/docs/reference/batch-and-bulk/reference.md#batch)
- [顧客OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## 完了通知

- [完了のWebhooksを受信し、確認する](https://flashdata.dev/ja/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## トラブルシューティング

- [エラーとステータスコード](https://flashdata.dev/ja/docs/errors/reference.md#status-codes)
- [再試行するとき](https://flashdata.dev/ja/docs/errors/reference.md#retries)

## 関連API

- [YouTube Search API](https://flashdata.dev/ja/docs/sources/youtube_search/reference.md)
- [YouTubeビデオメタデータAPI](https://flashdata.dev/ja/docs/sources/youtube_metadata/reference.md)
