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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine oder mehrere öffentliche Playlist-URLs mit einem list-Abfragewert oder reine Playlist-IDs, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale 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.
- Bereiten Sie eine oder mehrere öffentliche Playlist-URLs mit einem list-Abfragewert oder reine Playlist-IDs vor und entfernen Sie doppelte Verweise.
- 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.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status der Aufgabe succeeded oder failed ist.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- YouTube Channels API
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API