youtube/
trending-videos

Rufen Sie die Trendvideos einer Kategorie wie Nachrichten, Gaming oder Sport für jedes beliebige Land ab – nach Rang sortiert, mit Kanal, Aufrufzahl, Länge und Thumbnail.

YouTube Trending Videos API

7 Kategorien
Jedes Land
Nach Rang sortiert
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

YouTube Trending Videos

Die Trendseiten von YouTube ordnen für jedes Land die Videos, die in einer Kategorie wie Nachrichten, Gaming oder Sport gerade die meiste Aufmerksamkeit bekommen, und zeigen zu jedem Video Platz, Kanal, Aufrufzahl, Länge und wie lange der Upload zurückliegt. Wer diese Ranglisten verfolgt, sieht, welche Themen, Spiele und Creator in einem Markt gerade durchstarten und wie schnell ein Video in die Liste aufsteigt oder wieder herausfällt.

Funktionen der YouTube Trending Videos API

  • Trendseiten für sieben Kategoriencategory wählt die Trendseite news, gaming, sports, learning, courses, fashion oder shopping, sodass jede Aufgabe genau der Liste folgt, die Zuschauer dieser Kategorie sehen.
  • Jedes Land per Zwei-Buchstaben-Coderegion nimmt einen Code wie US, GB, JP oder BR an und liefert die Seite dieses Landes, die für dieselbe Kategorie oft andere Videos listet.
  • Rang bei jedem Videorank hält die Position jedes Videos ab 1 fest, zusammen mit category und region, sodass eine Zeile verständlich bleibt, auch wenn Sie mehrere Listen in einer Tabelle zusammenführen.
  • Der Kanal hinter jedem Trendvideoauthor enthält Kanal-ID, Name, @Handle, Link, Avatar und Verifizierungsabzeichen, sodass Sie Trendvideos ohne zweite Abfrage nach Kanal gruppieren können.
  • Aufrufe, Länge und Thumbnailmetrics.views_count, duration_seconds, thumbnail_url und der Beschreibungsausschnitt in text beschreiben jedes Video so, wie es auf der Trendseite erscheint.

Parameter der YouTube Trending Videos API

ParameterErforderlichBeschreibung
categoryErforderlichDie zu lesende Trendseite: news, gaming, sports, learning, courses, fashion oder shopping.
regionOptionalLändercode der Trendseite aus zwei Buchstaben, etwa US, GB oder JP. Standardwert ist US.
results_limitOptionalWie viele Videos ab dem Anfang der Liste zurückgegeben werden, von 1 bis 50. Standardwert ist 50.

So verwenden Sie die YouTube Trending Videos API

Wählen Sie eine Kategorie und ein Land, senden Sie beides an den Endpunkt YouTube Trending Videos API und lesen Sie die Rangliste aus der abgeschlossenen Aufgabe.

  1. Senden Sie {"category": "news", "region": "US", "results_limit": 50} per POST an /v1/youtube/trending-videos und notieren Sie die task_id.
  2. Fragen Sie GET /v1/tasks/{task_id} im Abstand weniger Sekunden ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Videos in results.items, sortiert nach rank; hat results.has_more den Wert true, übergeben Sie results.next_cursor, um die nächste Seite zu laden.
curl -X POST "https://api.socq.ai/v1/youtube/trending-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"gaming","region":"GB","results_limit":10}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the ranked videos once status is succeeded.

Anwendungsfälle der YouTube Trending Videos API

  • Tägliches Trend-Briefing für einen Markt: Rufen Sie jeden Morgen die Seiten für Nachrichten und Sport eines Landes ab und geben Sie der Redaktion die Titel, Kanäle und Aufrufzahlen, die gerade durchstarten, in Rangfolge weiter.
  • Gaming-Trends im Blick behalten: Verfolgen Sie die Gaming-Seite in den Ländern, in denen Sie veröffentlichen, und erkennen Sie aufsteigende Spiele, Formate und Creator, bevor Sie Videos oder Kampagnen planen.
  • Eine Kategorie über Länder hinweg vergleichen: Fragen Sie dieselbe Kategorie für mehrere Werte von region ab und legen Sie die Listen über die Video-ID nebeneinander, um zu sehen, welche Videos international laufen und welche lokal bleiben.
  • Eine Kontaktliste von Kanälen aufbauen: Sammeln Sie die Kanäle, die es immer wieder auf die Trendseite einer Kategorie schaffen, samt Handle und Verifizierungsabzeichen als Ausgangsliste für Partnerschaften.

Profi-Tipps zur YouTube Trending Videos API

  • Planen Sie dieselbe Kategorie und Region zu einer festen Uhrzeit ein und führen Sie die Durchläufe über id zusammen; ein veränderter rank zeigt, welche Videos steigen und welche nachlassen.
  • Lesen Sie published_time_text zusammen mit collected_at: Die Seite zeigt das Alter als Text wie „15 min ago“, ziehen Sie es also von der Erfassungszeit ab, wenn Sie eine ungefähre Upload-Zeit brauchen.
  • Setzen Sie results_limit auf 10 oder 20, wenn Sie nur die Spitze der Liste brauchen; YouTube Trending Videos API rechnet pro zurückgegebenem Video ab.
  • Übergeben Sie die gesammelten IDs an die YouTube Videos API für „Gefällt mir“-Angaben, Kommentare und die vollständige Beschreibung oder an die YouTube Transcripts API, um zu lesen, was in jedem Trendvideo gesagt wird.

Ergänzend zur YouTube Trending 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 Trending Videos API — FAQ

YouTube Trending Videos API ist eine Programmierschnittstelle, die für ein gewähltes Land die Trendvideos einer YouTube-Kategorie wie Nachrichten, Gaming oder Sport abruft. Sie liefert zu jedem Video Rang, Titel, Kanal, Aufrufzahl, Länge, Thumbnail und wie lange die Veröffentlichung zurückliegt.

Im Juli 2025 hat YouTube die einheitliche Trendseite durch Trendlisten für einzelne Kategorien ersetzt; die Gaming-Trends blieben auf der Gaming-Seite unter „Erkunden“. YouTube Trending Videos API liest diese Kategorieseiten, Sie wählen also die Kategorie, die Sie verfolgen möchten.

Setzen Sie region auf den Zwei-Buchstaben-Code des Landes, etwa JP für Japan oder DE für Deutschland. Jedes Land hat seine eigene Liste, sodass dieselbe Kategorie in jedem Markt andere Videos weit oben führen kann.

Nachrichten, Gaming, Sport, Lernen, Kurse, Mode und Shopping. Senden Sie eine Kategorie pro Aufgabe und starten Sie mehrere Aufgaben, um weitere abzudecken.

Bis zu 50 ab dem Anfang der Liste, festgelegt über results_limit. Eine Kategorie mit kürzerer Liste liefert die Videos, die sie enthält, und Sie zahlen nur für die Zeilen, die Sie erhalten.

YouTube Trending Videos API berechnet 0,5 Credits pro zurückgegebenem Video: Eine vollständige Liste mit 50 Videos kostet also 25 Credits, die ersten 10 kosten 5.