# FlashData API de recherche YouTube

Recherchez des vidéos YouTube par mot-clé et récupérez leurs titres, chaînes, durées, nombres de vues et vignettes au format JSON.

Référence canonique : https://flashdata.dev/fr/docs/sources/youtube_search
Révisé le : 2026-11-16

Endpoint: POST https://data.flashdata.dev/v1/queries/realtime
Authentification: X-API-Key: YOUR_API_KEY
Modes: [Temps réel](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#realtime) · [Asynchrone](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)

Autorisation requise pour la source: youtube_search

Remplacez YOUR_API_KEY par une clé API disposant de la permission requise pour cette source et d’un solde de crédits disponible. Exécutez les requêtes sur votre serveur ou dans l’environnement de votre agent.

[Configurer l’authentification](https://flashdata.dev/fr/docs/guides/headers-and-authentication/reference.md)

[Trouver des vidéos sur un sujet](https://flashdata.dev/fr/docs/guides/youtube-search-recipe/reference.md)

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

## Envoyer une requête

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

## Paramètres

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

### Corps de la requête

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Oui | — | Définissez ce champ sur youtube_search.  |
| <a id="parameter-query"></a> query | string | Oui | Non défini | Requête de recherche. Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params"></a> params | object | Non | {} | Paramètres de cette requête.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Non | Non défini | Async et Batch uniquement. URL HTTPS publique de notification sur le port 443, de 2 048 caractères maximum, sans identifiants ni fragment. Omettez ce champ, ou utilisez null ou une chaîne vide pour désactiver les notifications. Dans un Batch, définissez-le pour chaque requête, en dehors de params.  |

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

### Nombre de résultats

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | Non | 20 | Nombre de résultats demandé. Le nombre disponible peut être inférieur. Minimum : 1. Maximum : 20. |

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

### Filtres de recherche

| Paramètre | Type | Obligatoire | Par défaut | Description |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | Non | Non défini | Filtres facultatifs de date de publication, de type de résultat, de durée, de tri et de caractéristiques. Omettez ce champ ou utilisez null pour ne pas appliquer de filtres. Seuls les champs documentés sont acceptés. |
| <a id="parameter-params-filters-upload_date"></a> params.filters.upload_date | string | Non | Non défini | Filtrez par date de publication. Valeurs acceptées : "today", "last_hour", "this_week", "this_month", "this_year". Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params-filters-type"></a> params.filters.type | string | Non | Non défini | Filtrez par type de résultat. Valeurs acceptées : "video", "channel", "playlist", "movie". Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params-filters-duration"></a> params.filters.duration | string | Non | Non défini | Filtrez par durée de la vidéo en minutes. Valeurs acceptées : "<4", "4-20", ">20". Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params-filters-sort_by"></a> params.filters.sort_by | string | Non | Non défini | Ordre des résultats. Omettez ce champ pour conserver le tri par défaut de YouTube. Valeurs acceptées : "rating", "relevance", "view_count", "upload_date". Longueur minimale : 1. Longueur maximale : 2000. |
| <a id="parameter-params-filters-360"></a> params.filters.360 | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique 360.  |
| <a id="parameter-params-filters-3d"></a> params.filters.3d | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique 3d.  |
| <a id="parameter-params-filters-4k"></a> params.filters.4k | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique 4k.  |
| <a id="parameter-params-filters-creative_commons"></a> params.filters.creative_commons | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique Creative Commons.  |
| <a id="parameter-params-filters-hd"></a> params.filters.hd | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique hd.  |
| <a id="parameter-params-filters-hdr"></a> params.filters.hdr | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique hdr.  |
| <a id="parameter-params-filters-live"></a> params.filters.live | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique live.  |
| <a id="parameter-params-filters-location"></a> params.filters.location | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique location.  |
| <a id="parameter-params-filters-purchased"></a> params.filters.purchased | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique purchased.  |
| <a id="parameter-params-filters-subtitles"></a> params.filters.subtitles | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique subtitles.  |
| <a id="parameter-params-filters-vr180"></a> params.filters.vr180 | boolean | Non | Non défini | Définissez ce champ sur true pour exiger la caractéristique vr180.  |

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

## Lire le résultat

Enregistrez la réponse JSON d’une requête réussie dans response.json. Enregistrez le script ci-dessous dans read-response.py, dans le même dossier, puis exécutez python read-response.py. Il utilise uniquement la bibliothèque standard de Python et n’envoie aucune nouvelle requête.

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

## Exemple de réponse

Exemple enregistré ; les champs et les nombres de résultats dépendent de la source et des paramètres de la requête.
```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"
}
```

## Champs de réponse

| Champ | Type | Description |
| --- | --- | --- |
| source | string | Source API demandée. |
| status | string | done lorsque la requête realtime réussit. |
| created_at | string | Date et heure de création de la réponse au format ISO 8601. |
| usage.credits | number | Crédits facturés pour la requête selon votre offre. |
| results[0].query | string | Requête de recherche. |
| results[0].totalResults | integer | Nombre de résultats renvoyés. |
| results[0].results | array | Résultats de recherche dans l’ordre renvoyé. |
| results[0].results[].videoId | string | Identifiant de la vidéo YouTube. |
| results[0].results[].title | string | Titre de la vidéo. |
| results[0].results[].channel | string | Nom de la chaîne. |
| results[0].results[].channelId | string · nullable | Identifiant de la chaîne, lorsqu’il est disponible. |
| results[0].results[].channelUrl | string · nullable | URL de la chaîne, lorsqu’elle est disponible. |
| results[0].results[].duration | number · nullable | Durée de la vidéo en secondes. |
| results[0].results[].durationString | string · nullable | Durée de la vidéo sous forme lisible, lorsqu’elle est disponible. |
| results[0].results[].viewCount | number · nullable | Nombre de vues, lorsqu’il est disponible. |
| results[0].results[].uploadDate | string · nullable | Date de publication, lorsqu’elle est disponible. |
| results[0].results[].description | string · nullable | Extrait de la description, de 500 caractères maximum, ou null s’il est indisponible. |
| results[0].results[].thumbnails | array | URL et dimensions des vignettes. |

- Utilisez la recherche étendue pour obtenir plus de 20 résultats par requête.

## Formats de réponse

Les réponses sont en JSON par défaut. Choisissez un autre format avec ces en-têtes facultatifs.

- Accept: application/json (par défaut) ou text/plain. Le texte brut présente les mêmes champs dans une disposition lisible avec indentation.
- X-Respond-With: markdown. Ne définissez pas cet en-tête pour conserver les champs d’origine. Markdown fonctionne avec les deux formats de réponse.

Markdown est disponible pour les requêtes realtime et les résultats de tâches terminées.

Les champs ci-dessous décrivent la réponse JSON par défaut.

[Exemples de formats de requête et de réponse](https://flashdata.dev/fr/docs/guides/response-formats/reference.md#headers)

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

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

## Bases de l’API

Le générateur de requêtes et les exemples ci-dessus utilisent les paramètres de cette source. Consultez les exemples Python et cURL ci-dessous pour les étapes communes de soumission, de suivi et de récupération des résultats. Le corps d’une requête Batch est un objet JSON contenant queries ; chaque élément renvoie son propre identifiant de tâche.

- [Requête Async et reçu de soumission](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#async)

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

- [Vérifier l’état de la tâche](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#status)

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

- [Récupérer les résultats des tâches terminées](https://flashdata.dev/fr/docs/reference/realtime-and-async/reference.md#results)
- [Requêtes JSON Batch](https://flashdata.dev/fr/docs/reference/batch-and-bulk/reference.md#batch)
- [Spécification OpenAPI publique](https://flashdata.dev/docs/openapi.json)

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

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

## Notifications d'achèvement

- [Recevoir et vérifier les webhooks de fin de traitement](https://flashdata.dev/fr/docs/guides/async-batch/reference.md#webhooks)

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

## Dépannage

- [Erreurs et codes d’état](https://flashdata.dev/fr/docs/errors/reference.md#status-codes)
- [Quand réessayer](https://flashdata.dev/fr/docs/errors/reference.md#retries)

## API associées

- [API de recherche étendue YouTube](https://flashdata.dev/fr/docs/sources/youtube_search_extended/reference.md)
- [API de métadonnées vidéo YouTube](https://flashdata.dev/fr/docs/sources/youtube_metadata/reference.md)
