YouTube Shorts
YouTube Shorts sind Kurzvideos mit Titeln, Kanalkontext, Vorschaubildern, Dauer, Angaben zur Veröffentlichung, Einstufung der Quelle und sichtbarer Interaktion. Diese Inhalts- und Performance-Signale unterstützen die Formatforschung, den Vergleich von Creators, die Beobachtung von Trends und die Analyse von Kampagnen.
Funktionen der YouTube Shorts API
- Shorts-Sammlung über mehrere KanäleSammeln Sie öffentliche Shorts aus mehreren Kanal-URLs in einer einzigen Anfrage.
- Ergebnislimit pro KanalLegen Sie für jeden eingegebenen Kanal ein eigenes results_limit fest; der Standardwert ist 100.
- Normalisierte Short-MetadatenLiefert normalisierte Short-Identität, Inhaltsmetadaten, Vorschaubilder, Dauer, Veröffentlichungsdatum und den veröffentlichenden Kanal.
- Interaktionskennzahlen als MomentaufnahmeEnthält die öffentlichen Zahlen zu Aufrufen, „Gefällt mir“-Angaben und Kommentaren samt collected_at für spätere Vergleiche.
- Plattformeigener Umfang von ShortsNutzt die Einstufung von Shorts durch YouTube, statt Kurzvideos nur über Dauer oder Ausrichtung zu definieren.
Parameter der YouTube Shorts API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Öffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. |
results_limit | Optional | Maximale Anzahl infrage kommender Datensätze, die für jede eingegebene URL angefordert werden. Muss eine positive ganze Zahl sein; der Standardwert ist 100. |
So verwenden Sie die YouTube Shorts API
Erstellen Sie einen sauberen Strom von Kurzvideos für eine bekannte Kanalgruppe. Die Aufgabe trennt die Einstufung durch die Plattform von eigenen Formatregeln, die Sie später anwenden.
- Bereiten Sie öffentliche Kanal-URLs vor; URLs einzelner Shorts gehören zu Videos, wenn Sie sie direkt abrufen möchten.
- Senden Sie urls und results_limit per POST an /v1/youtube/shorts und berücksichtigen Sie dabei das Limit für jeden Kanal.
- Fragen Sie /v1/tasks/{task_id} ab, bis das Kanalinventar abgeschlossen ist.
- Indizieren Sie die Ergebnisse nach Short-ID, behalten Sie Kanal- und Erfassungskontext bei und paginieren Sie, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Anwendungsfälle der YouTube Shorts API
- Beobachtung der Aktivität bei Kurzvideos: Verfolgen Sie öffentliche Shorts, die von ausgewählten Creators, Marken, Verlagen oder Wettbewerbern veröffentlicht werden.
- Vergleich der Performance von Shorts: Vergleichen Sie Veröffentlichungsfrequenz, Dauer, Aufrufe, „Gefällt mir“-Angaben und Kommentare über ausgewählte Kanäle hinweg.
- Kataloge von Kurzvideo-Inhalten: Bauen Sie eine normalisierte Sammlung öffentlicher Shorts für interne Suche, Prüfung oder Berichte auf.
- Themen- und Trendanalyse: Nutzen Sie Titel, Beschreibungen, Hashtags, Kanaldaten und öffentliche Kennzahlen in Workflows für Klassifizierung oder Recherche.
Profi-Tipps zur YouTube Shorts API
- Stufen Sie Ergebnisse nicht mit einer universellen Dauergrenze neu ein. Die öffentliche Formateinstufung von YouTube ist die Spezifikation für diesen Endpunkt.
- Das Limit gilt pro Kanal und ist eine Obergrenze, keine Garantie. Manche Kanäle haben nur wenige oder keine infrage kommenden öffentlichen Shorts.
- Nutzen Sie die zurückgegebene ID zur Deduplizierung; dasselbe Element kann an anderer Stelle in Ihrem System über verschiedene öffentliche URL-Formen auftauchen.
- Behalten Sie collected_at zusammen mit den Kennzahlen, denn die sichtbaren Zähler eines Shorts können sich nach der Veröffentlichung schnell verändern.
- Dieser Endpunkt sucht nicht nach Keywords. Beginnen Sie für die Themenfindung mit Search und leiten Sie bekannte Short-URLs bei Bedarf über Videos.
- Sammeln Sie Channel Videos gesondert, wenn Sie einen sauberen Vergleich zwischen Kurzvideos und regulären Veröffentlichungen benötigen.
- Verknüpfen Sie Channels über die Kanal-ID für Profil- und Reichweitenfelder, statt veränderliche Kanalmetadaten bei jedem Element zu wiederholen.
Verwandte APIs
Ergänzend zur YouTube 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 Channel Live Videos API — Öffentliche Übertragungen erfassen, die in den Live-Bereichen eines Kanals angezeigt werden – mit Quellkontext und sichtbaren Kennzahlen.
- YouTube Search 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
- YouTube Trending Videos API