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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
url | Erforderlich | Ein 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.
- Senden Sie {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} per POST an /v1/youtube/related-videos.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API