# FlashData YouTube Channel API

Recuperare un profilo di canale YouTube e i suoi video recenti tramite maniglia, compresi i conteggi degli abbonati, le immagini dei canali e i dettagli video.

Riferimento canonico: https://flashdata.dev/it/docs/sources/youtube_channel
Recensito: 2026-10-23

Punto di arrivo: POST https://data.flashdata.dev/v1/queries/realtime
Autenticazione: X-API-Key: YOUR_API_KEY
Modalità: [Realtime](https://flashdata.dev/it/docs/reference/realtime-and-async/reference.md#realtime) · [Async](https://flashdata.dev/it/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/it/docs/reference/batch-and-bulk/reference.md#batch)

Permesso di origine richiesto: youtube_channel

Sostituisci YOUR_API_KEY con una chiave API che ha questo permesso di origine e crediti disponibili. Eseguire le richieste sul server o sul server host dell'agente.

[Impostare l'autenticazione](https://flashdata.dev/it/docs/guides/headers-and-authentication/reference.md)

[Lavorare con un canale e i suoi video recenti](https://flashdata.dev/it/docs/guides/youtube-data-guide/reference.md#channel)

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

## Invia una richiesta

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "youtube_channel",
    "handle": "@jawed",
    "params": {
        "video_limit": 10,
    },
}

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_channel",
  "handle": "@jawed",
  "params": {
    "video_limit": 10
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parametri

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

### Corpo della richiesta

| Parametro | Tipologia | Obbligatorio | Predefinito | Designazione |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sì | — | Impostare su youtube_channel.  |
| <a id="parameter-handle"></a> handle | string | Sì | Non impostato | Manico del canale, come @jawed. Il prefisso @ è facoltativo. Lunghezza minima: 1. Lunghezza massima: 100. |
| <a id="parameter-params"></a> params | object | No | {} | Settings per questa richiesta.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | No | Non impostato | Async e solo lotto. Completamento HTTPS pubblico URL sulla porta 443, fino a caratteri 2,048. Nessuna credenziali utente o frammentazione URL. Omit, utilizzare null o una stringa vuota per nessuna notifica. In un lotto, impostare questo su ogni query, param esterni.  |

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

### Selezione video

| Parametro | Tipologia | Obbligatorio | Predefinito | Designazione |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-video_limit"></a> params.video_limit | integer | No | 20 | Video massimi da includere. Potrebbero essere disponibili pochi. Minimo: 1. Massimo: 100. |

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

## Leggi il risultato

Salvare la risposta di successo JSON come response.json. Salvare questo come read-response.py ed eseguire pitone read-response.py. Utilizza solo la libreria standard di Python e non fa nuove richieste.

### 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 = {
    "channelId": result.get("channelId"),
    "name": result.get("name"),
    "videos": [
        {"videoId": item.get("videoId"), "title": item.get("title")}
        for item in result.get("videos", [])
    ],
}
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Risposta di esempio

Esempio registrato; i campi e i conti dipendono dalla fonte e dall'ingresso richiesto.
```json
{
  "source": "youtube_channel",
  "status": "done",
  "results": [
    {
      "channelId": "UC4QobU6STFB0P71PMvOGN5A",
      "channelHandle": "@jawed",
      "name": "jawed",
      "description": "",
      "subscriberCount": 6580000,
      "videoCount": 1,
      "viewCount": null,
      "avatarUrl": "https://yt3.googleusercontent.com/uI3VE4PVqvCy0xnWLqMJnEzyBUm3T8VHOCp4ee-1RxdHqKXCdUE_qXYQnpf9AfuEoIPactVyDhM=s0",
      "bannerUrl": null,
      "channelUrl": "https://www.youtube.com/channel/UC4QobU6STFB0P71PMvOGN5A",
      "videos": [
        {
          "videoId": "jNQXAC9IVRw",
          "title": "Me at the zoo",
          "duration": 19,
          "viewCount": 431000000,
          "uploadDate": null,
          "thumbnail": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg?sqp=-oaymwE2COADEI4CSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBvgKAAvABigIMCAAQARhVIFkoZTAP&rs=AOn4CLDkGJrAGBspJ5G6u9b7tutsHbloEg"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-09-16T07:41:47.218Z"
}
```

## Campi di risposta

| Campo di applicazione | Tipologia | Designazione |
| --- | --- | --- |
| source | string | La fonte API richiesta. |
| status | string | fatto quando la richiesta in tempo reale riesce. |
| created_at | string | Tempo di creazione di risposta in formato ISO 8601. |
| usage.credits | number | Crediti a carico della richiesta, in base al tuo piano. |
| results[0].channelId | string | Canale ID. |
| results[0].channelHandle | string | Manico del canale. |
| results[0].name | string | Nome del canale. |
| results[0].description | string | Descrizione del canale. |
| results[0].subscriberCount | number · nullable | Conto degli abbonati. |
| results[0].videoCount | number · nullable | Conto video canale totale. |
| results[0].viewCount | number · nullable | La vista del canale conta quando disponibile. |
| results[0].avatarUrl | string · nullable | Canale avatar URL. |
| results[0].bannerUrl | string · nullable | Canale banner URL. |
| results[0].channelUrl | string | Pagina canale URL. |
| results[0].videos | array | Video recenti, fino a video_limit voci. |
| results[0].videos[].videoId | string | Video ID. |
| results[0].videos[].title | string | Titolo video. |
| results[0].videos[].duration | number · nullable | Durata in pochi secondi. |
| results[0].videos[].viewCount | number · nullable | Vedi il conteggio. |
| results[0].videos[].uploadDate | string · nullable | Data di caricamento. |
| results[0].videos[].thumbnail | string · nullable | Video thumbnail URL. |

- videoCount descrive il canale; l'array video contiene solo i video recenti richiesti.

## Formati di risposta

Le risposte usano JSON per impostazione predefinita. Scegli un altro formato con queste intestazioni opzionali.

- Accept: application/json (predefinito) o text/plain. Testo normale presenta gli stessi campi in un layout leggibile e indentato.
- X-Respond-With: markdown. Lasciare unset per i campi originali. Markdown funziona con il formato di risposta.

Markdown è disponibile per domande in tempo reale e risultati completati.

I campi sottostanti descrivono la risposta predefinita JSON.

[Esempi di formato di richiesta e risposta](https://flashdata.dev/it/docs/guides/response-formats/reference.md#headers)

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

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

## Nozioni di base sulle API

Il costruttore di richieste ed esempi sopra usano i parametri di questa fonte. Utilizzare gli esempi Python e cURL qui sotto per la presentazione condivisa, lo stato e i passaggi di risultato. Un corpo Batch è un oggetto JSON contenente query; ogni elemento restituisce il proprio lavoro ID.

- [Async richiesta e ricevuta](https://flashdata.dev/it/docs/reference/realtime-and-async/reference.md#async)

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

- [Controllare lo stato del lavoro](https://flashdata.dev/it/docs/reference/realtime-and-async/reference.md#status)

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

- [Recuperare i risultati completati](https://flashdata.dev/it/docs/reference/realtime-and-async/reference.md#results)
- [richieste Batch JSON](https://flashdata.dev/it/docs/reference/batch-and-bulk/reference.md#batch)
- [Clienti OpenAPI](https://flashdata.dev/docs/openapi.json)

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

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

## Notifiche di completamento

- [Ricevi e verifica il completamento webhooks](https://flashdata.dev/it/docs/guides/async-batch/reference.md#webhooks)

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

## Risoluzione dei problemi

- [Errori e codici di stato](https://flashdata.dev/it/docs/errors/reference.md#status-codes)
- [Quando riprova](https://flashdata.dev/it/docs/errors/reference.md#retries)

## API correlate

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