Dokumentation durchsuchen
API-Referenz
YouTube Video Metadaten API
Abrufen von Video-Metadaten durch YouTube-Video ID, einschließlich Kanaldetails, Engagement-Zahlen, Miniaturansichten, verfügbare Formate und Kapitel.
Anfrage erstellen
Die 11 Zeichen lange ID aus der Video-URL, nicht die vollständige URL.
https://data.flashdata.dev/v1/queries/realtimeParameter
Senden source und video_id auf der obersten Ebene. Source-Optionen gehören in params. Optionale Felder können entfallen.
Anfrageinhalt
sourcestring / Erforderlich- Setzen Sie auf youtube_metadata.
video_idstring / Erforderlich- Das 11-Charakter YouTube Video ID, wie FUfGcZ092b0. Akzeptiert Buchstaben, Zahlen, Unterstriche und Bindestriche.Genau 11 ZeichenStandard:
Nicht eingestelltAkzeptiertes Format
^[A-Za-z0-9_-]{11}$ paramsobject / Optional- Settings für diese Anfrage.Standard:
{} callback_urlstring · nullable / Optional- Async und Batch nur. Öffentliche HTTPS Fertigstellung URL auf Port 443, bis zu 2,048 Zeichen. Keine Benutzeranmeldeinformationen oder URL-Fragment. Verwenden Sie null oder einen leeren String für keine Benachrichtigung. Setzen Sie dies in einem Batch auf jede Abfrage, außerhalb von Params.Standard:
Nicht eingestellt
Antwortoptionen
params.include_formatsboolean / Optional- Fügen Sie verfügbare Medienformate und deren Codec, Auflösungs- und Bitrateninformationen hinzu.
trueoderfalseStandard:true params.include_chaptersboolean / Optional- Fügen Sie Kapitel hinzu, wenn das Video sie enthält.
trueoderfalseStandard:true
Antwort
Realtime zurück status: done. Lesen Sie den Source Output auf results[0]; usage.credits die Ladung aufzeichnet.
Die Metadaten eines Videos umfassen videoId, Titel, Kanaldetails, Dauer und Engagement-Zahlen.
Lesen Sie das Ergebnis
Speichern Sie die erfolgreiche JSON-Antwort als response.json. Speichern Sie dies als read-response.py und führen Sie Python read-response.py aus. Es verwendet nur die Standardbibliothek von Python und stellt keine neue Anforderung.
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))Beide Antwortoptionen sind standardmäßig true, wenn sie weggelassen werden. Deaktivieren Sie include_formats für eine kleinere Antwort, wenn Sie nur Metadaten benötigen. Kapitel erscheinen nur, wenn sie angefordert und verfügbar sind. Nicht verfügbare Zählungen können null sein.
formats Beschreibt verfügbare Codierungen; es wird kein Video heruntergeladen. hasTranscripts und transcriptLanguages Beschreiben Sie die Verfügbarkeit, nicht den Transkriptionstext. Verwenden Sie die Download API für Medien und die Transkript API für Text.
Alle Antwortfelder
| Feld | Beschreibung |
|---|---|
sourcestring | Die angeforderte API-Quelle. |
statusstring | Dies geschieht, wenn die Echtzeitanforderung erfolgreich ist. |
created_atstring | Antworterstellungszeit im Format ISO 8601. |
usage.creditsnumber | Credits, die für die anfrage berechnet werden, basierend auf ihrem plan. |
results[0].videoIdstring | YouTube Video ID. |
results[0].titlestring | Videotitel. |
results[0].descriptionstring | Vollständige Videobeschreibung. |
results[0].channelstring | Kanalname. |
results[0].channelIdstring | Kanal ID. |
results[0].channelUrlstring | Kanal URL. |
results[0].channelSubscriberCountnumber · nullable | Kanalabonnentenzahl. |
results[0].viewCountnumber · nullable | View Count. |
results[0].likeCountnumber · nullable | Wie Zählen. |
results[0].commentCountnumber · nullable | Kommentierungszähler. |
results[0].uploadDatestring · nullable | Uploaddatum. |
results[0].durationnumber · nullable | Videodauer in Sekunden. |
results[0].durationStringstring · nullable | Formatierte Dauer, wenn verfügbar. |
results[0].thumbnailsarray | Thumbnail URLs und Abmessungen. |
results[0].categoriesarray | Video-Kategorien. |
results[0].tagsarray | Video-Tags. |
results[0].ageLimitinteger | Altersbeschränkung oder 0, wenn nicht eingeschränkt. |
results[0].isLiveboolean | Ob das Video derzeit live ist. |
results[0].wasLiveboolean | Ob das Video ein Live-Stream war. |
results[0].hasTranscriptsboolean | Ob Untertitel verfügbar sind. |
results[0].transcriptLanguagesarray | Verfügbare Untertitel-Sprachcodes. |
results[0].formatsarray · optional | Verfügbare Medienformate, wenn include_formats true ist. |
results[0].chaptersarray · optional | Kapiteltitel, start_time und end_time in Sekunden, wenn angefordert und verfügbar. |
Die obigen Felder beschreiben die Standardantwort von JSON. JSON, Klartext und Markdown Formate.
Async gibt eine Auftragsbestätigung zurück; Batch gibt eine pro Auftrag zurück Video ID. Überprüfen Sie den Status jedes Jobs und rufen Sie seine Ergebnisse mit den zurückgegebenen Links ab.
Async & Batch-Lebenszyklus
Die Einreichung gibt eine Quittung zurück, keine Ergebnisse. Async erstellt einen Job; batch gibt einen separaten Job in queries[] Für jede akzeptierte Abfrage. Verfolgen und Abrufen jedes Jobs unabhängig.
Einreichen von data.flashdata.dev; lesen Sie den Jobstatus und die Ergebnisse von api.flashdata.dev mit dem gleichen X-API-Key. Die verknüpften API-Grundlagenbeispiele verwenden Python und cURL.
1. Speichern Sie den Job IDs
Behalten Sie die Anforderungsfelder dieser Quelle bei, wenn Sie zu Async wechseln. Legen Sie für Batch jede Anfrage in das Abfrage-Array eines JSON-Objekts. Speichern Sie jeden zurückgegebenen Job ID.
2. Kontrollstatus
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: Umfrage mit Verzögerung und RespektRetry-Afterwenn vorhanden.completed: Ergebnisse holen.failed: Inspektionjob.error.Lesen Sie job.status, nicht den Status der Eingangsbestätigung.
Stellenstatus API-Referenz3. Abrufergebnisse
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsNach Abschluss authentifizieren Sie das gelesene Ergebnis und holen dann den 302-Speicher URL ohne Ihren API-Schlüssel ab. Speichern Sie den JSON innerhalb von 24 Stunden nach Fertigstellung.
Ergebnisse abrufen · Python und cURL · Antwortformate
Ergebnis Download API Referenz
Das Abfragen und Abrufen vorhandener Ergebnisse verbraucht keine Abfragegutschriften. Ein Polling-Timeout storniert den Job nicht: Behalten Sie seinen ID, anstatt doppelt abrechenbare Arbeit einzureichen. Fehlercodes und Wiederholverhalten.
Webhooks bei Abschluss
Abonnieren pro Abfrage
Setz callback_url auf der obersten Ebene einer async-Anfrage oder In jeder Abfrage in einer Charge, außen params. Es ist keine separate Webhook-Registrierungsanforderung erforderlich. Realtime-Anfragen senden keine Rückrufe.
Verwenden Sie ein öffentliches HTTPS URL auf Port 443. FlashData POST eine Benachrichtigung für jeden Job, der erreicht wird completed oder failed; Das Ereignis enthält Links, nicht das Ergebnis selbst.
Bestätigung und Überprüfung
Rückkehr 2xx nach dauerhafter Annahme des Ereignisses. Dedupliziert von delivery_id, auch gesendet als X-Delivery-Id. Redirects werden nicht befolgt.
Fehlgeschlagene Lieferungen wiederholen sich mit exponentiellem Backoff, bis zu 8 Versuche insgesamt und höchstens 24 Stunden nach Fertigstellung. Führen Sie Umfragen als Rückfall.
Callbacks sind nicht signiert. Bestätigen Sie den Job ID, den Quell- und Terminalstatus durch die authentifizierter Statusendpunkt vor der Bearbeitung der Benachrichtigung. Die Lieferung ID dient der Deduplizierung, nicht dem Nachweis der Echtheit.
Beispiel Webhook Event und Felder
{
"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"
}
]
}| Feld | Beschreibung |
|---|---|
delivery_idstring | Stabile Lieferkennung. Deduplizieren Sie Benachrichtigungen mit diesem Wert; es wird auch im X-Delivery-Id-Header gesendet. |
idstring | Job ID. |
sourcestring | Angeforderte Datenquelle. |
statusstring | vervollständigt oder fehlgeschlagen. |
linksarray | Status- und Ergebnislinks. Benachrichtigungen enthalten keinen Ergebnisinhalt oder einen API-Schlüssel. |
links[].relstring | Selbst oder Ergebnisse. |
links[].hrefstring | Absolute Management API URL; Authentifizierung mit Ihrem API-Schlüssel. |
links[].methodstring | GET. |
Bulk Dateiverarbeitung
Laden Sie ein Video ID pro Zeile hoch und erstellen Sie den Job Bulk mit der Quelle: youtube_metadata. Gemeinsame Optionen gelten für jede ID in der Datei.
Quellenoptionen: include_formats, include_chapters. Setzen Sie sie in Optionen, wenn Sie den Bulk-Job erstellen.
Holen Sie die fertige Sammlung als manifeste und gzip-komprimierte NDJSON Ergebnisteile ab. Datenquellen können auch Ergebnisteile in Ihren Cloud-Speicher liefern, indem Sie beim Erstellen des Bulk-Auftrags options.result_storage festlegen. Speichern Sie das Manifest und die Teile innerhalb von 24 Stunden nach Abschluss des gesamten Bulk-Auftrags.
Bulk Verarbeitung API · Python und cURL · Batch JSON Anfragen
Erstellen Sie einen Bulk-Workflow für diese Quelle · Pause, Wiederaufnahme und Wiederherstellung
Fehlerbehebung
Geben Sie ein 11-Charaktervideo ID an, kein vollständiges YouTube URL. Ein gültiges ID garantiert nicht, dass das Video zugänglich ist: Entfernte, private oder eingeschränkte Videos können während der Verarbeitung fehlschlagen. Fehlende Zählungen können null sein; abwesende Kapitel oder Formate sind nicht selbst Jobausfälle.
Für Authentifizierungs-, Balance-, Request-Format- und Rate-Limit-Fehler verwenden Sie die gemeinsame Fehlerreferenz. Ein Einreichungs-Timeout hat möglicherweise immer noch einen Job erstellt; Überprüfen Sie die vorhandene Arbeit, bevor Sie erneut versuchen.
Fehler und Statuscodes · Wann man es erneut versucht · Zinsbindungen
Schritt-für-Schritt Anleitung: Abrufen und Verwenden von Video-Metadaten
Preise
| Pläne | Nutzungssätzepro 1.000 Standardanfragen | Abonnements | Inklusive Credits pro Abrechnungszeitraum |
|---|---|---|---|
| Nutzungsabhängige Zahlung | 0,50 $ | Keine Monatsgebühr | Bei Bedarf aufladen |
| Micro | 0,40 $ | 49,00 $ / Monat | 1.000 Credits (50,00 $ von API Nutzung) enthalten |
| Starter | 0,35 $ | 199,00 $ / Monat | 4.000 Credits (200,00 $ von API Nutzung) enthalten |
| Pro | 0,30 $ | 499,00 $ / Monat | 10.000 Credits (500,00 $ von API Nutzung) enthalten |
| Scale | 0,25 $ | 999,00 $ / Monat | 20.000 Credits (1.000,00 $ von API Nutzung) enthalten |
| Business | 0,20 $ | 1.999,00 $ / Monat | 40.000 Credits (2.000,00 $ von API Nutzung) enthalten |
Ein Kontotarif. Gemeinsames Guthaben für alle drei Produkte. Durch enthaltenes Guthaben gedeckte Nutzung wird nicht erneut berechnet.
Aktuelle Preise und Planlimits