youtube/
playlist-videos

Normalisierte Videos aus öffentlichen YouTube-Playlist-URLs oder -IDs sammeln – mit Titeln, Kanalkontext, Vorschaubildern, Dauer und Herkunft der Playlist pro Datensatz.

YouTube Playlist Videos API

Playlist-Inventare
URL oder reine ID
Herkunft der Playlist
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

YouTube Playlist Videos

Playlist-Videos auf YouTube sind Einträge, die in einer öffentlichen Playlist zusammengefasst sind, mit Video-Identität, Titeln, Kanalkontext, Vorschaubildern, Dauer und Herkunft aus der Playlist. Diese Datensätze unterstützen die Katalogisierung von Playlists, die Indexierung von Serien, die Prüfung von Inhalten und die Anreicherung von Video-Links.

Funktionen der YouTube Playlist Videos API

  • Eingabe mehrerer Playlists per URL und IDVerarbeitet in einer Aufgabe eine oder mehrere öffentliche Playlist-URLs oder reine Playlist-IDs, wobei results_limit für jede aufgelöste Playlist separat gilt.
  • Normalisierte Zeilen des VideokatalogsLiefert Video-IDs, Titel, kanonische URLs, Kanalidentität, ein Vorschaubild, die Dauer in Sekunden und den Zeitpunkt der Erfassung in einer einheitlichen Struktur.
  • Herkunft aus Playlist und InhaberBehält Playlist-ID, Playlist-Titel, lesbaren Dauertext und den Kontext des Playlist-Inhabers bei, wenn eine Videozeile keine eigenen Kanalfelder bereitstellt.

Parameter der YouTube Playlist Videos API

ParameterErforderlichBeschreibung
urlsErforderlichEine oder mehrere öffentliche Playlist-URLs mit einem list-Abfragewert oder reine Playlist-IDs, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale Anzahl an Datensätzen, die aus dem zurückgegebenen Video-Array jeder Playlist übernommen werden; der Standardwert ist 100, zulässig sind ganze Zahlen von 10 bis 2.000.

So verwenden Sie die YouTube Playlist Videos API

Senden Sie bekannte öffentliche Playlist-Verweise als asynchrone Aufgabe und blättern Sie nach dem Erfolg der Aufgabe durch die gespeicherten normalisierten Videozeilen.

  1. Bereiten Sie eine oder mehrere öffentliche Playlist-URLs mit einem list-Abfragewert oder reine Playlist-IDs vor und entfernen Sie doppelte Verweise.
  2. Senden Sie urls und optional ein results_limit von 10 bis 2.000 per POST an /v1/youtube/playlist-videos und speichern Sie anschließend die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis der Status der Aufgabe succeeded oder failed ist.
  4. Lesen Sie data.results.items und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat; gleichen Sie Playlist-IDs und Video-IDs mit Ihrer Quellmenge ab.
curl -X POST "https://api.socq.ai/v1/youtube/playlist-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/playlist?list=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Anwendungsfälle der YouTube Playlist Videos API

  • Inventare öffentlicher Playlists: Bauen Sie für ausgewählte öffentliche Playlists ein strukturiertes Inventar aus Video-IDs, Titeln, URLs, Kanalidentität, Vorschaubildern, Dauer und Herkunft aus der Playlist auf.
  • Indexierung von Kursen und Serien: Indexieren Sie Playlist-Titel zusammen mit Videotiteln, Kanalkontext, Laufzeiten und Quell-Links, um öffentliche Kurse, Vorträge oder episodische Sammlungen zu ordnen.
  • Startlisten für die Anreicherung von Videos: Verwenden Sie die zurückgegebenen kanonischen Video-URLs und IDs als deduplizierte Warteschlange für getrennte Workflows zu Details, Transkripten, Bewertungen oder Archivierung.

Profi-Tipps zur YouTube Playlist Videos API

  • Verwenden Sie entweder eine reine Playlist-ID oder eine URL mit gefülltem list-Abfragewert; andere URL-Bestandteile werden nicht zur Auflösung der Playlist herangezogen, und eine URL ohne list wird übersprungen.
  • Behandeln Sie results_limit als Obergrenze pro Playlist über das erste zurückgegebene Video-Array und nicht als Garantie für eine tiefe Extraktion bei einer großen Playlist.
  • Bringen Sie jede Playlist vor dem Batch in eine einheitliche Darstellung, denn nur exakt identische Zeichenfolgen werden entfernt und URL-Varianten derselben Playlist können wiederholte Arbeit auslösen.
  • Vergleichen Sie die zurückgegebenen Werte extra.playlist_id und Video-id mit Ihrer Eingabemenge, denn private, gelöschte, eingeschränkte, ausgeblendete, fehlerhafte oder nicht verfügbare Einträge können fehlen.
  • Nutzen Sie collected_at für die Herkunft der Datensätze und fordern Sie Videodetails gesondert an, wenn Veröffentlichungsdaten oder Interaktion benötigt werden, denn metrics ist leer und created_at ist null.

Ergänzend zur YouTube Playlist Videos API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher YouTube-Daten benötigen.

  • YouTube Channel Videos API — Reguläre öffentliche Videos aus Kanal-URLs erfassen – ohne Shorts und Livestreams.
  • YouTube Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
  • YouTube Transcripts API — Verfügbare Klartext-Transkripte mit optionaler Sprachauswahl abrufen.
  • YouTube Videos API — Metadaten, Thumbnails, Dauer und Interaktionen zu bekannten Video- oder Short-URLs abrufen.
  • YouTube Shorts API — Öffentliche Shorts, Thumbnails, Dauer, Veröffentlichungsdetails und Interaktionen pro Kanal erfassen.
  • YouTube Channel Live Videos API — Öffentliche Übertragungen erfassen, die in den Live-Bereichen eines Kanals angezeigt werden – mit Quellkontext und sichtbaren Kennzahlen.

Weitere Plattformen entdecken

Kombinieren Sie YouTube-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

YouTube Playlist Videos API — FAQ

YouTube Playlist Videos API ist eine Schnittstelle zum Sammeln normalisierter Videozeilen aus öffentlichen YouTube-Playlist-URLs oder reinen Playlist-IDs. Sie liefert Video-Identität, Titel, kanonische URLs, Kanalkontext, Vorschaubilder, Dauer, Herkunft aus der Playlist und den Zeitpunkt der Erfassung.

Senden Sie ein nicht leeres Array urls mit Playlist-URLs, die einen list-Abfragewert enthalten, oder mit reinen Playlist-IDs. results_limit ist optional, hat den Standardwert 100, akzeptiert 10 bis 2.000 und gilt separat für jede Playlist.

Jeder Datensatz kann Video-ID, Titel, kanonische URL, Kanal-ID, Handle, Name und URL des Kanals, ein Vorschaubild, die Dauer in Sekunden, den Erfassungszeitpunkt, Playlist-ID, Playlist-Titel und lesbaren Dauertext enthalten. Das normalisierte Objekt metrics ist leer und created_at ist null.

Nein. Position in der Playlist, Gesamtzahl der Videos, Abspielbarkeit und Status nicht verfügbarer Einträge werden nicht gespeichert, und fehlende Einträge werden nicht durch Platzhalter-Datensätze abgebildet.

Nein. Das Limit begrenzt die Videos, die aus einem zurückgegebenen Video-Array pro Playlist übernommen werden; der aktuelle Collector fordert keine Fortsetzungsseiten der Quelle an.

Eine Playlist kann weniger Datensätze liefern, wenn sie privat, nicht verfügbar, fehlerhaft, nicht auflösbar oder eingeschränkt ist oder ausgeblendete und nicht zugängliche Einträge enthält. Eine URL ohne nicht leeren list-Abfragewert wird übersprungen.

Die Nutzung kostet 0,5 Credits für jeden zurückgegebenen normalisierten Videodatensatz, ohne Grundgebühr. Leere Ergebnisse verursachen nach der aktuellen Regel für leere Ergebnisse keine Kosten pro Ergebnis.