# FlashData YouTube  Busca Extendida API

Recupere até 700 YouTube resultados de busca por solicitação, com detalhes de vídeo, miniaturas e filtros de pesquisa.

Referência canônica: https://flashdata.dev/pt/docs/sources/youtube_search_extended
Revisado: 2026-11-16

Ponto final: POST https://data.flashdata.dev/v1/queries/realtime
Autenticação: X-API-Key: YOUR_API_KEY
Modos: [Realtime](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch)

Precisou de permissão de origem: youtube_search_extended

Substitua YOUR_API_KEY por uma chave API que tem essa permissão de fonte e créditos disponíveis. Execute pedidos no seu servidor ou host de agente.

[Configurar autenticação](https://flashdata.dev/pt/docs/guides/headers-and-authentication/reference.md)

[Planeje uma busca por candidatos maiores](https://flashdata.dev/pt/docs/guides/youtube-data-guide/reference.md#extended)

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

## Envie um pedido

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

## Parâmetros

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

### Corpo da requisição

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sim | — | Preparar para youtube_search_extended.  |
| <a id="parameter-query"></a> query | string | Sim | Não está pronto | Pesquisando. Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params"></a> params | object | Não | {} | Settings para este pedido.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | Não | Não está pronto | Async e apenas lote. HTTPS conclusão URL na porta 443, até caracteres 2,048. Sem credenciais de usuário ou fragmento URL. Omit, use null ou uma string vazia para nenhuma notificação. Em um lote, coloque isso em cada consulta, fora dos parâmetros.  |

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

### Contagem de resultados

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-max_results"></a> params.max_results | integer | Não | 20 | Número de resultados solicitados. Menos resultados podem estar disponíveis. Mínimo: 1. Máximo: 700. |

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

### Filtros de busca

| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-filters"></a> params.filters | object · nullable | Não | Não está pronto | Opcional data de envio, tipo de resultado, duração, triagem e filtros de recursos. Omitir ou usar null sem filtros. Apenas campos documentados são aceitos. |
| <a id="parameter-params-filters-upload_date"></a> params.filters.upload_date | string | Não | Não está pronto | Filtrar pela data de envio. Permite: "today", "last_hour", "this_week", "this_month", "this_year". Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params-filters-type"></a> params.filters.type | string | Não | Não está pronto | Filtrar pelo tipo de resultado. Permitido: "video", "channel", "playlist", "movie". Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params-filters-duration"></a> params.filters.duration | string | Não | Não está pronto | Filtrar pela duração do vídeo em minutos. Permitido: "<4", "4-20", ">20". Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params-filters-sort_by"></a> params.filters.sort_by | string | Não | Não está pronto | Ordenação do resultado. Omita usar a ordem padrão do YouTube. Permitido: "rating", "relevance", "view_count", "upload_date". Comprimento mínimo: 1. Comprimento máximo: 2000. |
| <a id="parameter-params-filters-360"></a> params.filters.360 | boolean | Não | Não está pronto | Defina o verdadeiro para exigir o recurso 360.  |
| <a id="parameter-params-filters-3d"></a> params.filters.3d | boolean | Não | Não está pronto | Configure para exigir o recurso 3D.  |
| <a id="parameter-params-filters-4k"></a> params.filters.4k | boolean | Não | Não está pronto | Configure para exigir o recurso 4k.  |
| <a id="parameter-params-filters-creative_commons"></a> params.filters.creative_commons | boolean | Não | Não está pronto | Definam o que é preciso para o recurso comum criativo.  |
| <a id="parameter-params-filters-hd"></a> params.filters.hd | boolean | Não | Não está pronto | Configure para exigir o recurso HD.  |
| <a id="parameter-params-filters-hdr"></a> params.filters.hdr | boolean | Não | Não está pronto | Configure para exigir o recurso HDR.  |
| <a id="parameter-params-filters-live"></a> params.filters.live | boolean | Não | Não está pronto | É verdade que precisa de um recurso ao vivo.  |
| <a id="parameter-params-filters-location"></a> params.filters.location | boolean | Não | Não está pronto | Configure para exigir o recurso de localização.  |
| <a id="parameter-params-filters-purchased"></a> params.filters.purchased | boolean | Não | Não está pronto | Defina o verdadeiro para exigir o recurso comprado.  |
| <a id="parameter-params-filters-subtitles"></a> params.filters.subtitles | boolean | Não | Não está pronto | Defina o verdadeiro para exigir o recurso de legendas.  |
| <a id="parameter-params-filters-vr180"></a> params.filters.vr180 | boolean | Não | Não está pronto | Defina para exigir o recurso vr180.  |

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

## Leia o resultado

Salve a resposta JSON bem sucedida como response.json. Guarde isso como read-response.py e execute python read-response.py. Ele usa apenas a biblioteca padrão do Python e não faz nenhum novo pedido.

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

## Exemplo de resposta

Exemplo gravado; campos e conta depende da fonte e entrada solicitada.
```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"
}
```

## Campos de resposta

| Campo | Tipo | Descrição |
| --- | --- | --- |
| source | string | A fonte API solicitada. |
| status | string | Feito quando o pedido em tempo real for bem sucedido. |
| created_at | string | Tempo de criação de resposta no formato ISO 8601. |
| usage.credits | number | Créditos cobrados pelo pedido, baseado no seu plano. |
| results[0].query | string | A busca. |
| results[0].totalResults | integer | Número de resultados retornados. |
| results[0].results | array | Resultados da pesquisa em sua ordem de retorno. |
| results[0].results[].videoId | string | YouTube vídeo ID. |
| results[0].results[].title | string | Título do vídeo. |
| results[0].results[].channel | string | Nome do canal. |
| results[0].results[].channelId | string · nullable | Canal ID quando disponível. |
| results[0].results[].channelUrl | string · nullable | Canal URL quando disponível. |
| results[0].results[].duration | number · nullable | Duração do vídeo em segundos. |
| results[0].results[].durationString | string · nullable | Duração de vídeo formatada quando disponível. |
| results[0].results[].viewCount | number · nullable | Veja a contagem quando disponível. |
| results[0].results[].uploadDate | string · nullable | Data de envio quando disponível. |
| results[0].results[].description | string · nullable | Excerto de descrição, até caracteres 500, ou nulo quando não está disponível. |
| results[0].results[].thumbnails | array | Thumbnail URLs e dimensões. |

- Ambas as APIs de pesquisa padrão para resultados 20. A pesquisa estendida aceita max_results até 700 e tem uma taxa de uso separada.

## Formatos de resposta

Respostas usam JSON por padrão. Escolha outro formato com esses cabeçalhos opcionais.

- Accept: application/json (padrão) ou text/plain. Texto simples apresenta os mesmos campos em um layout legível e indentado.
- X-Respond-With: markdown. Deixe de lado os campos originais. Markdown funciona com qualquer formato de resposta.

Markdown está disponível para consultas em tempo real e resultados completos.

Os campos abaixo descrevem a resposta padrão JSON.

[Requisito e formatação de resposta exemplos](https://flashdata.dev/pt/docs/guides/response-formats/reference.md#headers)

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

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

## Conceitos básicos da API

O construtor de pedidos e exemplos acima usam os parâmetros desta fonte. Use os exemplos Python e cURL abaixo para submissão compartilhada, status e passos de resultado. Um corpo Batch é um objeto JSON contendo consultas, cada item retorna seu próprio trabalho ID.

- [Async pedido e recibo](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#async)

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

- [Verifique o status do trabalho](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#status)

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

- [Recupere resultados completados](https://flashdata.dev/pt/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON pedidos](https://flashdata.dev/pt/docs/reference/batch-and-bulk/reference.md#batch)
- [Cliente OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Notificações de conclusão

- [Receba e verifique os hooks de conclusão](https://flashdata.dev/pt/docs/guides/async-batch/reference.md#webhooks)

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

## Solução de problemas

- [Erros e códigos de status](https://flashdata.dev/pt/docs/errors/reference.md#status-codes)
- [Quando tentar novamente](https://flashdata.dev/pt/docs/errors/reference.md#retries)

## APIs relacionadas

- [YouTube Search API](https://flashdata.dev/pt/docs/sources/youtube_search/reference.md)
- [YouTube Video Metadata API](https://flashdata.dev/pt/docs/sources/youtube_metadata/reference.md)
