Sfoglia la documentazione
Riferimento API
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.
Crea una richiesta
Inserisci l’handle del canale, ad esempio @youtube, non il suo URL.
https://data.flashdata.dev/v1/queries/realtimeParametri
Invia source e handle al livello superiore. Le opzioni di origine appartengono in params. I campi opzionali possono essere omessi.
Corpo della richiesta
sourcestring / Obbligatorio- Impostare su youtube_channel.
handlestring / Obbligatorio- Manico del canale, come @jawed. Il prefisso @ è facoltativo.1 a 100 caratteriPredefinito:
Non impostato paramsobject / Facoltativo- Settings per questa richiesta.Predefinito:
{} callback_urlstring · nullable / Facoltativo- 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.Predefinito:
Non impostato
Selezione video
params.video_limitinteger / Facoltativo- Video massimi da includere. Potrebbero essere disponibili pochi.1 a 100, numeri interiPredefinito:
20
Risposta
Realtime restituisce status: done. Leggi l'output sorgente results[0].videos; usage.credits registra l'accusa.
Il profilo del canale è in risultati[0]; la sua gamma di video contiene video recenti. videoCount descrive il canale e non è la lunghezza dell'array restituito.
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.
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))Invia la maniglia al livello superiore, con o senza il prefisso @. video_limit appartiene ai params e accetta 1 a 100; si predefinisce 20. L'esempio richiede 10.
Il limite richiesto è un massimo, non una garanzia. I conteggi, l'immagine URLs e i dettagli per-video possono essere null quando non disponibili.
Tutti i campi di risposta
| Campo di applicazione | Designazione |
|---|---|
sourcestring | La fonte API richiesta. |
statusstring | fatto quando la richiesta in tempo reale riesce. |
created_atstring | Tempo di creazione di risposta in formato ISO 8601. |
usage.creditsnumber | Crediti a carico della richiesta, in base al tuo piano. |
results[0].channelIdstring | Canale ID. |
results[0].channelHandlestring | Manico del canale. |
results[0].namestring | Nome del canale. |
results[0].descriptionstring | Descrizione del canale. |
results[0].subscriberCountnumber · nullable | Conto degli abbonati. |
results[0].videoCountnumber · nullable | Conto video canale totale. |
results[0].viewCountnumber · nullable | La vista del canale conta quando disponibile. |
results[0].avatarUrlstring · nullable | Canale avatar URL. |
results[0].bannerUrlstring · nullable | Canale banner URL. |
results[0].channelUrlstring | Pagina canale URL. |
results[0].videosarray | Video recenti, fino a video_limit voci. |
results[0].videos[].videoIdstring | Video ID. |
results[0].videos[].titlestring | Titolo video. |
results[0].videos[].durationnumber · nullable | Durata in pochi secondi. |
results[0].videos[].viewCountnumber · nullable | Vedi il conteggio. |
results[0].videos[].uploadDatestring · nullable | Data di caricamento. |
results[0].videos[].thumbnailstring · nullable | Video thumbnail URL. |
I campi sopra descritti descrivono la risposta predefinita JSON. formati JSON, testo semplice e Markdown.
Async restituisce una ricevuta di lavoro; il lotto restituisce uno per maniglia del canale. Controllare lo stato di ogni lavoro e recuperare i risultati utilizzando i link restituiti.
Async & ciclo di vita in batch
La sottomissione restituisce una ricevuta, non i risultati. Async crea un lavoro; batch restituisce un lavoro separato in queries[] per ogni domanda accettata. Tracciare e recuperare ogni lavoro in modo indipendente.
Inviare a data.flashdata.dev; leggi lo stato del lavoro e i risultati ottenuti api.flashdata.dev con lo stesso X-API-Key. Gli esempi di base API collegati utilizzano Python e cURL.
1. Salvare il lavoro IDs
Mantenere i campi di richiesta di questa fonte quando si passa a Async. Per Batch, inserire ogni richiesta all'interno dell'array query di un oggetto JSON. Salvare ogni lavoro restituito ID.
2. Controllare lo stato
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: sondaggio con ritardo e rispettoRetry-Afterquando presente.completed: risultati di ricerca.failed: ispezionejob.error.Leggi job.status, non lo stato della ricevuta di presentazione.
Stato di controllo · Python e cURL
Stato del lavoro API riferimento3. Risultati di riduzione
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsDopo il completamento, autenticare il risultato letto, quindi prendere il 302 di archiviazione URL senza la chiave API. Salvare la JSON entro le ore di completamento 24.
Risultati di riduzione · Python e cURL · Formati di risposta
Risultato download API riferimento
L'inquinamento e l'ottenimento dei risultati esistenti non consumano i crediti di query. Un timeout inquinante non cancella il lavoro: mantieni il suo ID invece di presentare il lavoro duplicato fatturabile. Codici di errore e comportamento di riprovazione.
Webhook di completamento
Iscriviti per query
Set Set callback_url al livello superiore di una richiesta asincrona, o dentro ogni query in un lotto, fuori params. Non è richiesta alcuna richiesta di registrazione webhook separata. Le richieste di Realtime non inviano i callback.
Utilizzare un HTTPS URL pubblico sulla porta 443. FlashData POSTs una notifica per ogni lavoro che raggiunge completed o failed; l'evento contiene collegamenti, non il risultato stesso.
Riconoscimento e verifica
Ritorno 2xx dopo aver accettato duramente l'evento. Deduplicato da delivery_id, anche inviato come X-Delivery-Id. I reindirizzamenti non sono seguiti.
Recuperare le consegne non effettuate con backoff esponenziale, fino a 8 tenta totale e al massimo 24 ore dopo il completamento. Continua a inquinare come un fallback.
Le chiamate non sono firmate. Confermare il lavoro ID, lo stato sorgente e terminale attraverso endpoint di stato autenticato prima di elaborare la notifica. La consegna ID è per la deduplica, non la prova di autenticità.
Esempio webhook evento e campi
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_channel",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Campo di applicazione | Designazione |
|---|---|
delivery_idstring | Identificatore di consegna stabile. Deduplicare le notifiche utilizzando questo valore; viene inviato anche nell'intestazione X-Delivery-Id. |
idstring | Lavoro ID. |
sourcestring | Fonte di dati richiesta. |
statusstring | completato o fallito. |
linksarray | Collegamenti di stato e di risultato. Le notifiche non includono il contenuto dei risultati o una chiave API. |
links[].relstring | auto o risultati. |
links[].hrefstring | Gestione assoluta API URL; autenticare con la chiave API. |
links[].methodstring | GET. |
Recupero di errore
Utilizzare una maniglia del canale, non un video ID o un canale completo URL. Un canale rimosso o inaccessibile può fallire anche quando la maniglia passa la validazione dell'ingresso. Le immagini o i conti mancanti non significano loro stessi fallimento.
Per l'autenticazione, l'equilibrio, il formato delle richieste e i guasti dei limiti di velocità, utilizzare il riferimento di errore condiviso. Un timeout di presentazione può ancora aver creato un lavoro; controllare il lavoro esistente prima di riprovare.
Guida passo-passo: Lavorare con un canale e i suoi video recenti
Prezzi
| Piani | Tassi di utilizzoper 1.000 richieste standard | Abbonamenti | Crediti inclusi per periodo di fatturazione |
|---|---|---|---|
| A consumo | 0,50 USD | Nessun canone mensile | Ricarica quando serve |
| Micro | 0,40 USD | 49,00 USD / mese | Crediti 1000 (50,00 USD dell'utilizzo API) inclusi |
| Starter | 0,35 USD | 199,00 USD / mese | Crediti 4000 (200,00 USD dell'utilizzo API) inclusi |
| Pro | 0,30 USD | 499,00 USD / mese | Crediti 10.000 (500,00 USD dell'utilizzo API) inclusi |
| Scale | 0,25 USD | 999,00 USD / mese | Crediti 20.000 (1000,00 USD dell'utilizzo API) inclusi |
| Business | 0,20 USD | 1999,00 USD / mese | Crediti 40.000 (2000,00 USD dell'utilizzo API) inclusi |
Un piano per account. Crediti condivisi tra i tre prodotti. L’utilizzo coperto dai crediti inclusi non viene addebitato nuovamente.
I prezzi attuali e i limiti del piano