# FlashData YouTube Search API

فتش أشرطة فيديو YouTube بالكلمات الرئيسية واستعادة ألقاب، وقنوات، ومدة، وحسابات النظر، والاصابع، بوصفها JSON.

مرجع كانوني: https://flashdata.dev/ar/docs/sources/youtube_search
جرى استعراضها: 2026-11-16

نقطة النهاية: POST https://data.flashdata.dev/v1/queries/realtime
المصادقة: X-API-Key: YOUR_API_KEY
Modes: [Realtime](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch)

إذن المصدر المطلوب: youtube_search

يستعاض عن YOUR_API_KEY بمفتاح API الذي يملك هذا المصدر من الأذن والائتمانات المتاحة. أجري طلبات على خادمك أو وكيل مضيف.

[إقامة المصادقة](https://flashdata.dev/ar/docs/guides/headers-and-authentication/reference.md)

[البحث عن أشرطة فيديو لموضوع](https://flashdata.dev/ar/docs/guides/youtube-search-recipe/reference.md)

<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",
    "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",
  "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.  |
| <a id="parameter-query"></a> query | string | نعم | غير محدد | باحث. صغر المدة: 1. أقصى مدة: 2000. |
| <a id="parameter-params"></a> params | object | لا | {} | Settings for this request.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | لا | غير محدد | لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.  |

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

### عدد النتائج

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | لا | 20 | عدد النتائج المطلوبة. وقد تكون هناك نتائج أقل. الحد الأدنى: 1. الحد الأقصى: 20. |

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

### تصفية البحث

| البارامترات | النوع | مطلوب | الافتراضي | الوصف |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | لا | غير محدد | تاريخ التحميل الاختياري، ونوع النتائج، والمدة، والفرز، ومرشحات المعالم. أو الاستخدام null بدون مرشحين. Only documented fields are accepted. |
| <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طلب غير مقصود. مسموع: "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 لتطلب المميزة الرابعة.  |
| <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 لتطلب خاصية (هيد)  |
| <a id="parameter-params-filters-hdr"></a> params.filters.hdr | boolean | لا | غير محدد | المجموعة true لتطلب خاصية (الهدر)  |
| <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 (لإشتراط سمّية (فور180  |

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

## اقرأ النتيجة

وفّر ردّ شركة JSON الناجح على أنها response.json. احفظ هذا read-response.py و اركضوا بيثون 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",
  "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": "_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": "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": "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": "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": "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": "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": "Gx5qb1uHss4",
          "title": "10 Important Python Concepts In 20 Minutes",
          "channel": "Indently",
          "channelId": "UCuudpdbKmQWq2PPzYgVCWlA",
          "channelUrl": "https://www.youtube.com/channel/UCuudpdbKmQWq2PPzYgVCWlA",
          "duration": 1129,
          "durationString": "18:49",
          "viewCount": 1585314,
          "uploadDate": null,
          "description": "In today's video we are going to be learning about 10 important Python concepts. ▷ Become job-ready with Python: ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/Gx5qb1uHss4/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBBEBFVOzsLpm5Msfq-tf3c5RL53A",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/Gx5qb1uHss4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB2Fqjbvuj3RxKd21DIvcgdpJyJ8w",
              "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": "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": "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": "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": "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": "t8pPdKYpowI",
          "title": "Python Tutorial for Beginners - Learn Python in 5 Hours [FULL COURSE]",
          "channel": "TechWorld with Nana",
          "channelId": "UCdngmbVKX1Tgre699-XLlUA",
          "channelUrl": "https://www.youtube.com/channel/UCdngmbVKX1Tgre699-XLlUA",
          "duration": 19890,
          "durationString": "5:31:30",
          "viewCount": 6863624,
          "uploadDate": null,
          "description": "Grab your free IT Fundamentals Roadmap: https://bit.ly/3GV5Noy Hands-On course to learn the complete SDLC - from code to ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/t8pPdKYpowI/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDBBWEVe-XMQgtxlBNiti-4F1tlPw",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/t8pPdKYpowI/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAg-ArVjF42XbZm4NPk1fzdVFGxrA",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "kLZgQWjnUz0",
          "title": "Learn Python – Interactive Course 2026",
          "channel": "freeCodeCamp.org",
          "channelId": "UC8butISFwT-Wl7EV0hUK0BQ",
          "channelUrl": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",
          "duration": 14916,
          "durationString": "4:08:36",
          "viewCount": 162778,
          "uploadDate": null,
          "description": "Discover Python, one of the most in-demand programming languages, from the ground up, building three real projects along the ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/kLZgQWjnUz0/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA9Yh_GDFMSvcLNWG7IuC3k3j0EoA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/kLZgQWjnUz0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAZ8G8R8OC76NPAS0_OPIv7P_qj3w",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "fWjsdhR3z3c",
          "title": "Learn Python in Less than 10 Minutes for Beginners (Fast & Easy)",
          "channel": "Indently",
          "channelId": "UCuudpdbKmQWq2PPzYgVCWlA",
          "channelUrl": "https://www.youtube.com/channel/UCuudpdbKmQWq2PPzYgVCWlA",
          "duration": 630,
          "durationString": "10:30",
          "viewCount": 1688176,
          "uploadDate": null,
          "description": "In this crash course I'll be teaching you the basics of Python in less than 10 minutes. Python is super easy to learn compared to ...",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/fWjsdhR3z3c/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBWamJZbnevfLEYEK0k5mhW1R6s6A",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/fWjsdhR3z3c/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDoA1aaTMk7h_rP2cN9IX_vp25R0g",
              "width": 720,
              "height": 404
            }
          ]
        },
        {
          "videoId": "PLGjplNEQ1it8-0CmoljS5yeV-GlKSUEt0",
          "title": "Python Language Full Course (2026)",
          "channel": "Shradha Khapra",
          "channelId": "UC1XBh-m27kkgwLAwu_SRJBg",
          "channelUrl": "https://www.youtube.com/channel/UC1XBh-m27kkgwLAwu_SRJBg",
          "duration": null,
          "durationString": null,
          "viewCount": null,
          "uploadDate": null,
          "description": null,
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/t2_Q2BRzeEE/hq720.jpg?sqp=-oaymwEXCOgCEMoBSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBV8aEMU97pJzBMjS2V3YnuudUUmA",
              "width": 360,
              "height": 202
            },
            {
              "url": "https://i.ytimg.com/vi/t2_Q2BRzeEE/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBm5_nQyrAnm5zyJ2FBA9l3BKyzMA",
              "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
            }
          ]
        }
      ],
      "totalResults": 20,
      "query": "python"
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:41:45.295Z"
}
```

## حقول الاستجابة

| الميدان | النوع | الوصف |
| --- | --- | --- |
| 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 video 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 | Description excerpt, up to 500 characters, or null when unavailable. |
| results[0].results[].thumbnails | array | Thumbnail URLs and dimensions. |

- إستعملْ البحث الموسّع عندما تَحتاجُ أكثر مِنْ 20 النتائج حسب الطلب.

## تنسيقات الاستجابة

وتستخدم الردود JSON حسب التقصير. اختر شكلاً آخر مع هؤلاء المرشدين الاختياريين

- Accept: application/json (التقصير) أو text/plain. ويعرض النص الشاذ نفس الحقول في مخطط قابل للقراءة ومستقطب.
- X-Respond-With: markdown. إتركوا الحقول الأصلية وتعمل شركة Markdown بأي من شكلي الاستجابة.

يتوفر Markdown للاستعلامات الفورية والنتائج المكتملة.

وتصف المجالات الواردة أدناه رد شركة JSON.

[أمثلة صيغ الطلب والاستجابة](https://flashdata.dev/ar/docs/guides/response-formats/reference.md#headers)

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

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

## أساسيات API

يستخدم منشئ الطلبات والأمثلة أعلاه معاملات هذا المصدر. استخدم أمثلة Python وcURL أدناه لخطوات الإرسال والحالة والنتائج المشتركة. جسم Batch هو كائن JSON يحتوي queries؛ ويعيد كل عنصر معرّف مهمة خاصًا به.

- [Async Request and receipt](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#async)

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

- [التحقق من حالة العمل](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#status)

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

- [استرجاع النتائج المنجزة](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md#batch)
- [العملاء المفتوحون](https://flashdata.dev/docs/openapi.json)

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

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

## الإخطارات المتعلقة بالإنجاز

- [استلام وثائق الإنجاز على شبكة الإنترنت والتحقق منها](https://flashdata.dev/ar/docs/guides/async-batch/reference.md#webhooks)

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

## اضطرابات

- [الأخطاء ورموز الحالة](https://flashdata.dev/ar/docs/errors/reference.md#status-codes)
- [متى يُعيدُ النظر](https://flashdata.dev/ar/docs/errors/reference.md#retries)

## APIs ذات الصلة

- [YouTube ممتدة للبحث API](https://flashdata.dev/ar/docs/sources/youtube_search_extended/reference.md)
- [YouTube Video Metadata API](https://flashdata.dev/ar/docs/sources/youtube_metadata/reference.md)
