# FlashData YouTube 확장 검색 API

최대 700 YouTube 검색 결과 요청 당, 비디오 세부 사항, 썸네일 및 검색 필터.

Canonical 참고: https://flashdata.dev/ko/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/ko/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ko/docs/reference/batch-and-bulk/reference.md#batch)

필수 소스 권한: youtube_search_extended

YOUR_API_KEY를 API 키로 교체하여 소스 권한 및 사용 가능한 크레딧을 제공합니다. 서버 또는 에이전트 호스트에 대한 요청을 실행합니다.

[인증 설정](https://flashdata.dev/ko/docs/guides/headers-and-authentication/reference.md)

[더 큰 후보 검색 계획](https://flashdata.dev/ko/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 또는 알림이 없는 빈 문자열을 사용하십시오. 일괄 처리에서, 각 쿼리에 설정, 외부 params.  |

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

### 결과 수

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | 의 아니 | 20 | 요청된 결과 수. Fewer 결과는 사용할 수 있습니다. 최소: 1. 최대: 700. |

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

### 검색 필터

| 제품 설명 | 유형 | 필수 | 기본값 | 의 특징 |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | 의 아니 | 설정하기 | 옵션 업로드 날짜, 결과 유형, 기간, 정렬 및 기능 필터. Omit 또는 필터가 없는 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 | 의 아니 | 설정하기 | 결과 주문. YouTube의 기본 주문을 사용하려면 Omit. 허용된: "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 | 의 아니 | 설정하기 | true를 설정하여 HD 기능을 필요로 합니다.  |
| <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 | Thumbnail URLs 및 치수. |

- 20 결과에 API를 기본적으로 검색합니다. 확장된 검색은 max_results를 700까지 수용하고 별도의 사용률을 가지고 있습니다.

## 응답 형식

응답은 기본적으로 JSON를 사용합니다. 이 선택적인 우두머리를 가진 다른 체재를 선택하십시오.

- Accept: application/json (기본 정보) 또는 text/plain. 일반 텍스트는 읽기 가능한 동일한 필드를 제공하며 들여쓰는 레이아웃을 나타냅니다.
- X-Respond-With: markdown. 원래 필드에 대 한 unset를 남겨 주세요. Markdown는 응답 체재로 작동합니다.

Markdown는 실시간 쿼리 및 완료 결과를 위해 사용할 수 있습니다.

아래 필드는 기본 JSON 응답을 설명합니다.

[요청 및 응답 형식 예](https://flashdata.dev/ko/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/ko/docs/reference/realtime-and-async/reference.md#async)

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

- [작업 상태 확인](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#status)

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

- [완료된 결과를 읽으십시오](https://flashdata.dev/ko/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON 요청](https://flashdata.dev/ko/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/ko/docs/guides/async-batch/reference.md#webhooks)

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

## 관련 상품

- [오류와 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md#status-codes)
- [재발행](https://flashdata.dev/ko/docs/errors/reference.md#retries)

## 관련 API

- [YouTube Search API](https://flashdata.dev/ko/docs/sources/youtube_search/reference.md)
- [YouTube 비디오 메타 데이터 API](https://flashdata.dev/ko/docs/sources/youtube_metadata/reference.md)
