# FlashData YouTube Tìm kiếm mở rộng API

Lấy lại đến 700 YouTube Kết quả tìm kiếm cho mỗi yêu cầu, với chi tiết phim ảnh, hình thu nhỏ và bộ lọc tìm kiếm.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/sources/youtube_search_extended
Xem lại: 2026-11-16

Điểm kết thúc: POST https://data.flashdata.dev/v1/queries/realtime
Xác thực: X-API-Key: YOUR_API_KEY
Chế độ: [Realtime](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)

Cần thiết quyền truy cập nguồn: youtube_search_extended

Thay thế YOUR_API_KEY với một API Chìa khóa mà có quyền sử dụng nguồn này và tín dụng sẵn có. Chạy yêu cầu trên máy chủ hay máy phục vụ.

[Đang thiết lập xác thực](https://flashdata.dev/vi/docs/guides/headers-and-authentication/reference.md)

[Lên kế hoạch tìm kiếm ứng cử viên lớn hơn](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md#extended)

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

## Gửi một yêu cầu

### 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>

## Tham số

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

### Nội dung yêu cầu

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Vâng | — | Thiết lập youtube_search_extended.  |
| <a id="parameter-query"></a> query | string | Vâng | Chưa đặt | Truy vấn tìm kiếm. Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params"></a> params | object | Không | {} | Settings cho yêu cầu này.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Không | Chưa đặt | Async và chỉ một mẻ. Chung HTTPS hoàn tất URL trên cổng 443Đến 2,048 các nhân vật. Không có phân khúc người dùng hay URL. Omit, dùng null hoặc chuỗi rỗng không cho thông báo nào. Trong một mẻ, đặt nó trên mỗi câu hỏi, bên ngoài các tham số.  |

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

### Số lượng kết quả

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | Không | 20 | Yêu cầu số lượng kết quả. Có thể ít có kết quả hơn. Tối thiểu: 1. Tối đa: 700. |

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

### Bộ lọc tìm kiếm

| Tham số | Kiểu | Bắt buộc | Mặc định | Mô tả |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | Không | Chưa đặt | Ngày tải lên tùy chọn, kiểu kết quả, thời gian, bộ lọc sắp xếp và tính năng. Omit hay sử dụng null không có bộ lọc. Chỉ có những lĩnh vực được ghi nhận mới được chấp nhận. |
| <a id="parameter-params-filters-upload_date"></a> params.filters.upload_date | string | Không | Chưa đặt | Lọc bằng ngày tải lên. Cho phép: "today", "last_hour", "this_week", "this_month", "this_year". Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params-filters-type"></a> params.filters.type | string | Không | Chưa đặt | Kiểu lọc theo kết quả. Cho phép: "video", "channel", "playlist", "movie". Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params-filters-duration"></a> params.filters.duration | string | Không | Chưa đặt | Lọc theo đoạn phim trong phút. Cho phép: "<4", "4-20", ">20". Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params-filters-sort_by"></a> params.filters.sort_by | string | Không | Chưa đặt | Kết quả đặt hàng. Omit cần dùng YouTubeLệnh mặc định. Cho phép: "rating", "relevance", "view_count", "upload_date". Chiều dài tối thiểu: 1. Chiều dài tối đa: 2000. |
| <a id="parameter-params-filters-360"></a> params.filters.360 | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng 360.  |
| <a id="parameter-params-filters-3d"></a> params.filters.3d | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng 3d.  |
| <a id="parameter-params-filters-4k"></a> params.filters.4k | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng 4k.  |
| <a id="parameter-params-filters-creative_commons"></a> params.filters.creative_commons | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng chung sáng tạo.  |
| <a id="parameter-params-filters-hd"></a> params.filters.hd | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng hd.  |
| <a id="parameter-params-filters-hdr"></a> params.filters.hdr | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng hdr.  |
| <a id="parameter-params-filters-live"></a> params.filters.live | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng sống.  |
| <a id="parameter-params-filters-location"></a> params.filters.location | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng vị trí.  |
| <a id="parameter-params-filters-purchased"></a> params.filters.purchased | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng mua.  |
| <a id="parameter-params-filters-subtitles"></a> params.filters.subtitles | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng phụ đề.  |
| <a id="parameter-params-filters-vr180"></a> params.filters.vr180 | boolean | Không | Chưa đặt | Đặt true để yêu cầu tính năng vr180.  |

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

## Đọc kết quả

Cứu người thành công JSON trả lời response.json. Lưu cái này vào read-response.py và chạy python read-response.py. Nó chỉ dùng thôi. PythonThư viện thông thường và không có yêu cầu mới.

### 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))
```

## Phản hồi mẫu

Ví dụ được thu; trường và số phụ thuộc vào nguồn và yêu cầu nhập.
```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"
}
```

## Trường đáp ứng

| Tìm kiếm | Kiểu | Mô tả |
| --- | --- | --- |
| source | string | Nguồn API đã yêu cầu. |
| status | string | hoàn thành khi yêu cầu thời gian thực thành công. |
| created_at | string | Thời gian tạo ra đáp ứng trong ISO 8601 Định dạng. |
| usage.credits | number | Các nguồn tin cho yêu cầu, dựa trên kế hoạch của anh. |
| results[0].query | string | Truy vấn tìm kiếm. |
| results[0].totalResults | integer | Số kết quả đã trở lại. |
| results[0].results | array | Kết quả là họ được lệnh trở về. |
| results[0].results[].videoId | string | YouTube video ID. |
| results[0].results[].title | string | Tiêu đề video. |
| results[0].results[].channel | string | Tên kênh. |
| results[0].results[].channelId | string · nullable | Kênh ID khi sẵn sàng. |
| results[0].results[].channelUrl | string · nullable | Kênh URL khi sẵn sàng. |
| results[0].results[].duration | number · nullable | Đoạn phim kéo dài chỉ trong vài giây. |
| results[0].results[].durationString | string · nullable | Định dạng đoạn phim khi có thể. |
| results[0].results[].viewCount | number · nullable | Xem lúc sẵn sàng. |
| results[0].results[].uploadDate | string · nullable | Tải lên ngày tháng khi sẵn sàng. |
| results[0].results[].description | string · nullable | Mô tả đoạn văn, đến 500 ký tự, hay null khi không có. |
| results[0].results[].thumbnails | array | Mẫu ảnh URLs và kích thước. |

- Cả hai đều mặc định tìm kiếm ADIs 20 Kết quả. Tìm kiếm mở rộng chấp nhận max_results lên đến 700 và có tốc độ sử dụng riêng biệt.

## Định dạng phản hồi

Đáp ứng được dùng JSON theo mặc định. Chọn một định dạng khác với những đầu trang tùy chọn này.

- Accept: application/json (mặc định) hay text/plain. Văn bản thường trình bày cùng một lĩnh vực trong một bố trí có thể đọc được, được in lề.
- X-Respond-With: markdown. Hãy để lại chỗ trống cho những cánh đồng nguyên thủy. Markdown hoạt động với định dạng trả lời.

Markdown có sẵn cho các yêu cầu thời gian thực và kết quả hoàn tất.

Các trường bên dưới mô tả giá trị mặc định JSON Trả lời đi.

[Ví dụ định dạng đáp ứng yêu cầu](https://flashdata.dev/vi/docs/guides/response-formats/reference.md#headers)

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

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

## Kiến thức cơ bản về API

Các yêu cầu xây dựng và ví dụ trên sử dụng các tham số của nguồn này. Sử dụng Python và cURL Những ví dụ bên dưới để được chia sẻ sự phục tùng, địa vị và kết quả là bước. A Batch Cơ thể là một JSON Đối tượng chứa các đồ thị; mỗi món đồ trả lại công việc của chính mình ID.

- [Async yêu cầu và biên lai](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async)

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

- [Kiểm tra tình trạng công việc](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#status)

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

- [Lấy kết quả hoàn tất](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON yêu cầu](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)
- [Trình khách OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Thông báo đầy đủ

- [Nhận và kiểm tra hoàn tất kết nối web](https://flashdata.dev/vi/docs/guides/async-batch/reference.md#webhooks)

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

## Khắc phục sự cố

- [Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md#status-codes)
- [Khi nào cần thử lại](https://flashdata.dev/vi/docs/errors/reference.md#retries)

## API liên quan

- [YouTube Search API](https://flashdata.dev/vi/docs/sources/youtube_search/reference.md)
- [YouTube Siêu dữ liệu ảnh động API](https://flashdata.dev/vi/docs/sources/youtube_metadata/reference.md)
