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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
category | Erforderlich | Die zu lesende Trendseite: news, gaming, sports, learning, courses, fashion oder shopping. |
region | Optional | Ländercode der Trendseite aus zwei Buchstaben, etwa US, GB oder JP. Standardwert ist US. |
results_limit | Optional | Wie 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.
- Senden Sie {"category": "news", "region": "US", "results_limit": 50} per POST an /v1/youtube/trending-videos und notieren Sie die task_id.
- Fragen Sie GET /v1/tasks/{task_id} im Abstand weniger Sekunden ab, bis status den Wert succeeded hat.
- 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.
Verwandte APIs
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.
- 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 Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API