youtube/
related-videos

Die Videos, die YouTube neben einem Video empfiehlt, über dessen URL auflisten – mit Titel, Kanal, Aufrufzahl und Vorschaubild jeder Empfehlung in einem Durchlauf.

YouTube Related Videos API

Video-URL als Eingabe
Empfehlungen für „Nächstes Video“
Kanal und Aufrufe
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

YouTube Related Videos

Ähnliche Videos sind die Empfehlungen, die YouTube neben einem Video als nächste Videos zum Ansehen aufreiht, jeweils mit Titel, Kanal, Aufrufzahl und Vorschaubild. Diese Liste zeigt, welche Videos und Kanäle YouTube im selben Umfeld verortet, und hilft so, eine Nische abzubilden, konkurrierende Kanäle zu finden und Inhalte zu planen, die neben einem Zielvideo erscheinen.

Funktionen der YouTube Related Videos API

  • Jeder gängige VideolinkAus Watch-URLs, youtu.be-Kurzlinks, Shorts-Links und Live-Links wird jeweils die Video-ID gelesen.
  • Die ganze Liste in einem DurchlaufEine Aufgabe liefert die vollständige Empfehlungsliste, die YouTube zu diesem Video anzeigt, in der Regel rund 20 Videos.
  • Wer hinter jeder Empfehlung stehtauthor enthält Kanal-ID, Name und Kanal-URL hinter jedem empfohlenen Video.
  • Aufrufe und Vorschaubildmetrics.views_count wird aus der von YouTube angezeigten Zahl gelesen, etwa „2.2M“, und media liefert das größte Vorschaubild.

Parameter der YouTube Related Videos API

ParameterErforderlichBeschreibung
urlErforderlichEin YouTube-Videolink: eine Watch-URL, ein youtu.be-Link, ein Shorts-Link oder ein Live-Link.

So verwenden Sie die YouTube Related Videos API

Senden Sie einen Videolink und lesen Sie die Empfehlungen aus.

  1. Senden Sie {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} per POST an /v1/youtube/related-videos.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Empfehlungen aus results.items und folgen Sie results.next_cursor, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

# Each item is one recommended video with author and metrics.views_count.

Anwendungsfälle der YouTube Related Videos API

  • Eine Nische rund um ein Video abbilden: Gehen Sie von einem starken Video aus, erfassen Sie seine Empfehlungen und wiederholen Sie das für diese Ergebnisse, um das Cluster von Videos darzustellen, das YouTube zusammen gruppiert.
  • Konkurrierende Kanäle finden: Zählen Sie, wie oft jede author.id neben Ihren eigenen Uploads erscheint, um zu sehen, welche Kanäle YouTube immer wieder neben Ihnen empfiehlt.
  • Prüfen, wo Ihr Video empfohlen wird: Führen Sie den Endpunkt für beliebte Videos der Konkurrenz aus und suchen Sie in deren Listen nach Ihren eigenen Video-IDs.

Profi-Tipps zur YouTube Related Videos API

  • Betrachten Sie views_count als Näherungswert: Er stammt aus gerundetem Anzeigetext wie „2.2M“.
  • Empfehlungen verändern sich mit der Zeit; speichern Sie daher collected_at mit jeder Liste, wenn Sie Durchläufe vergleichen.
  • Senden Sie die Video-URLs, die Sie behalten, an YouTube Videos, um exakte Zahlen, Veröffentlichungsdaten und Laufzeiten zu erhalten.

Ergänzend zur YouTube Related 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 Channels API — Öffentliche Kanalidentität, Bilder, Verifizierung und sichtbare Statistiken zur Zielgruppe 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.

Weitere Plattformen entdecken

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

YouTube Related Videos API — FAQ

YouTube Related Videos API ist eine Schnittstelle zum Auflisten der Videos, die YouTube neben einem bestimmten Video empfiehlt, anhand der URL dieses Videos. Sie liefert für jede Empfehlung Titel, Kanal, Aufrufzahl und Vorschaubild.

Er liefert die ganze Liste, die YouTube zu diesem Video anzeigt, in der Regel rund 20 Videos.

Ja. Shorts-Links, youtu.be-Links, Live-Links und reguläre Watch-URLs werden alle akzeptiert.

Nicht mehr. Die offizielle Data API unterstützt den Suchparameter relatedToVideoId seit dem 7. August 2023 nicht mehr; mit diesem Endpunkt lesen Sie die Liste aus, die YouTube neben einem Video anzeigt.

Jedes zurückgegebene empfohlene Video kostet 0,5 Credits, eine typische Liste mit 20 Videos kostet also 10 Credits.