youtube/
trending-shorts

Eine Stichprobe der Shorts ziehen, die gerade auf YouTube im Trend liegen, ganz ohne Eingabe – mit Titeln, Kanälen, Aufrufen, „Gefällt mir“-Angaben, Kommentaren, Dauer und exakten Veröffentlichungszeitpunkten.

YouTube Trending Shorts API

Keine Eingabe erforderlich
Neue Stichprobe bei jedem Durchlauf
Aufrufe, Likes, Kommentare
0,5 Credits pro Ergebnis
Bereit
README

Von SocQ · Aktualisiert am

YouTube Trending Shorts

Trending Shorts sind die Hochformatvideos, die YouTube gerade einem breiten Publikum zuspielt, jeweils mit Titel, dem Kanal dahinter, Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren, Länge und dem genauen Zeitpunkt der Veröffentlichung. Zusammen gelesen zeigen diese Signale, welche Themen, Formate und Creator gerade durchstarten und wie schnell ein Short nach seiner Veröffentlichung Aufrufe sammelt.

Funktionen der YouTube Trending Shorts API

  • Direkt aus dem Trend-PoolSie müssen nichts ausfüllen: Jeder Durchlauf zieht die Shorts, die YouTube in diesem Moment bewirbt, rund 48 pro Ziehung, und wiederholte Ziehungen werden ohne Duplikate bis results_limit zusammengeführt.
  • Drei Interaktionszahlen pro Shortmetrics enthält exakte Zahlen zu Aufrufen und „Gefällt mir“-Angaben sowie die von YouTube angezeigte Kommentarzahl, sodass sich ein viel diskutierter Short von einem abhebt, der nur angesehen wird.
  • Kanal zu jedem Shortauthor enthält Kanal-ID, Handle, Name, URL und Avatar, bereit zur Übergabe an Endpunkte auf Kanalebene.
  • Veröffentlichungszeitpunkt und Längepublished_at ist der genaue Upload-Zeitpunkt in UTC und duration_seconds die Laufzeit; zusammen zeigen sie, wie neu und wie lang ein Trend-Short ist.
  • Hashtags aus der BeschreibungHashtags aus Titel oder Beschreibung werden in hashtags aufgeführt, ohne das führende #.

Parameter der YouTube Trending Shorts API

ParameterErforderlichBeschreibung
results_limitOptionalWie viele Trending Shorts zurückgegeben werden, von 1 bis 200. Standardwert ist 48.

So verwenden Sie die YouTube Trending Shorts API

Senden Sie optional eine Ergebnisanzahl und lesen Sie die Shorts aus, sobald die Aufgabe abgeschlossen ist.

  1. Senden Sie {"results_limit": 48} per POST an /v1/youtube/trending-shorts; der Body kann auch leer sein.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Shorts 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/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

Anwendungsfälle der YouTube Trending Shorts API

  • Tägliche Trend-Momentaufnahmen: Führen Sie den Endpunkt zu festen Zeiten aus und speichern Sie jede Charge, um zu sehen, welche Themen und Formate in den Trending Shorts immer wieder auftauchen.
  • Durchstartende Creator erkennen: Vergleichen Sie views_count mit published_at, um Kanäle zu finden, deren neue Uploads innerhalb weniger Tage Millionen Aufrufe erzielen.
  • Hashtag-Beobachtung für Shorts: Zählen Sie die Hashtags in den Trending Shorts, um zu sehen, welche Hashtags diese Woche mit viralen Kurzvideos mitlaufen.

Profi-Tipps zur YouTube Trending Shorts API

  • Jeder Durchlauf ist eine neue Stichprobe; speichern Sie daher die id jedes Shorts und überspringen Sie Wiederholungen, wenn Sie Durchläufe im Abstand weniger Minuten zusammenführen.
  • Teilen Sie views_count durch die Stunden seit published_at, um Shorts nach Tempo statt nach Gesamtaufrufen zu ordnen.
  • Senden Sie author.url an YouTube Channels, wenn Sie zusätzlich Abonnentenzahlen und Kanalbeschreibungen benötigen.

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

YouTube Trending Shorts API ist eine Schnittstelle zum Ziehen einer Stichprobe der Shorts, die YouTube aktuell als Trend bewirbt, ganz ohne Sucheingabe. Sie liefert für jeden Short Titel, Kanal, Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren, Dauer und Veröffentlichungszeitpunkt.

Jeder Durchlauf zieht eine neue Stichprobe aus dem Trend-Pool, sodass Durchläufe im Abstand weniger Minuten nur eine Handvoll Shorts gemeinsam haben. Wenn Sie mehrere Durchläufe planen und nach id zusammenführen, erhalten Sie einen breiteren Überblick über die aktuellen Trends.

Setzen Sie results_limit auf einen Wert von 1 bis 200; Standardwert ist 48, was etwa einer Ziehung aus dem Trend-Pool entspricht.

Aufrufe und „Gefällt mir“-Angaben ja: views_count und likes_count sind vollständige Ganzzahlen aus jedem Short. comments_count folgt dem Wert, den YouTube anzeigt, daher werden Zahlen über tausend gerundet, zum Beispiel 4800 für „4.8K“, und „Gefällt mir“-Angaben oder Kommentare sind null, wenn ein Creator sie ausblendet.

Es gibt keinen Länderparameter. Jeder Durchlauf liefert die Shorts, die sich in diesem Moment im Trend-Pool befinden; planen Sie daher Durchläufe und führen Sie sie nach id zusammen, um zu verfolgen, wie sich der Pool verändert.

Jeder zurückgegebene Short kostet 0,5 Credits, die standardmäßigen 48 Shorts kosten also 24 Credits.