Sfoglia la documentazione
Riferimento API
YouTube Video Metadati API
Recuperare i metadati video di YouTube video ID, compresi i dettagli del canale, conteggi di fidanzamento, miniature, formati e capitoli disponibili.
Crea una richiesta
L’ID di 11 caratteri presente nell’URL del video, non l’URL completo.
https://data.flashdata.dev/v1/queries/realtimeParametri
Invia source e video_id al livello superiore. Le opzioni di origine appartengono in params. I campi opzionali possono essere omessi.
Corpo della richiesta
sourcestring / Obbligatorio- Impostare su youtube_metadata.
video_idstring / Obbligatorio- Il video 11-character YouTube video ID, come FUfGcZ092b0. Accetta lettere, numeri, sottolineature e trattini.Esattamente. 11 caratteriPredefinito:
Non impostatoFormato accettato
^[A-Za-z0-9_-]{11}$ 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
Opzioni di risposta
params.include_formatsboolean / Facoltativo- Includere i formati multimediali disponibili e il loro codec, la risoluzione e le informazioni bitrate.
trueofalsePredefinito:true params.include_chaptersboolean / Facoltativo- Includi i capitoli quando il video li ha.
trueofalsePredefinito:true
Risposta
Realtime restituisce status: done. Leggi l'output sorgente results[0]; usage.credits registra l'accusa.
I metadati di un video includono videoId, il titolo, i dettagli del canale, la durata e i conteggi di fidanzamento.
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 = {name: result.get(name) for name in (
"videoId", "title", "channel", "duration", "hasTranscripts", "transcriptLanguages"
)}
print(json.dumps(output, ensure_ascii=False, indent=2))Entrambe le opzioni di risposta di default a true quando omesso. Disattiva include_formats per una risposta più piccola quando hai solo bisogno di metadati. I capitoli appaiono solo quando sono richiesti e disponibili. I conti non disponibili possono essere null.
formats descrive le codifiche disponibili; non scarica un video. hasTranscripts e transcriptLanguages descrivere la disponibilità, non trascrizione del testo. Utilizzare Scarica API per i media e Trascrizione API per il testo.
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].videoIdstring | YouTube video ID. |
results[0].titlestring | Titolo video. |
results[0].descriptionstring | Descrizione video completa. |
results[0].channelstring | Nome del canale. |
results[0].channelIdstring | Canale ID. |
results[0].channelUrlstring | Canale URL. |
results[0].channelSubscriberCountnumber · nullable | Conto di abbonati di canale. |
results[0].viewCountnumber · nullable | Vedi il conteggio. |
results[0].likeCountnumber · nullable | Come contare. |
results[0].commentCountnumber · nullable | Conto di commento. |
results[0].uploadDatestring · nullable | Data di caricamento. |
results[0].durationnumber · nullable | Durata video in pochi secondi. |
results[0].durationStringstring · nullable | Durata formattata quando disponibile. |
results[0].thumbnailsarray | Thumbnail URLs e dimensioni. |
results[0].categoriesarray | Le categorie video. |
results[0].tagsarray | Video tags. |
results[0].ageLimitinteger | Limite di età, o 0 quando non limitato. |
results[0].isLiveboolean | Se il video è attualmente in diretta. |
results[0].wasLiveboolean | Che il video sia stato un flusso live. |
results[0].hasTranscriptsboolean | Se sono disponibili le didascalie. |
results[0].transcriptLanguagesarray | Codici di lingue didascalia disponibili. |
results[0].formatsarray · optional | Formati multimediali disponibili quando include_formats è true. |
results[0].chaptersarray · optional | Titoli di capitolo, start_time e end_time in secondi, quando richiesto e disponibile. |
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 video ID. 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_metadata",
"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. |
Trattamento file Bulk
Caricare un video ID per linea e creare il lavoro Bulk con la fonte: youtube_metadata. Le opzioni condivise si applicano a ogni ID nel file.
Opzioni di origine: include_formats, include_chapters. Mettile in opzioni quando si crea il lavoro Bulk.
Recuperare la collezione completa come parti di risultato NDJSON e gzip-compresse. Le fonti di dati possono anche fornire parti di risultato al cloud storage impostando options.result_storage quando si crea il lavoro Bulk. Salvare il manifesto e le parti all'interno di 24 ore dopo che l'intero lavoro Bulk è completato.
Bulk che elabora API · Python e cURL · richieste Batch JSON
Costruire un flusso di lavoro Bulk per questa sorgente · Pausa, riprendere e recuperare
Recupero di errore
Fornire un video 11-character ID, non un completo YouTube URL. Un valido ID non garantisce che il video sia accessibile: i video rimossi, privati o ristretti possono fallire durante l'elaborazione. I conti mancanti possono essere null; i capitoli o i formati assenti non sono essi stessi guasti di lavoro.
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: Recuperare e utilizzare i metadati video
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