youtube/
shorts

Öffentliche Shorts aus YouTube-Kanal-URLs sammeln – mit normalisierten Titeln, Kanalkontext, Vorschaubildern, Dauer, Angaben zur Veröffentlichung und sichtbarer Interaktion.

YouTube Shorts API

Shorts
Kanalentdeckung
Öffentliche Kennzahlen
0,5 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche.
results_limitOptionalMaximale 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.

  1. Bereiten Sie öffentliche Kanal-URLs vor; URLs einzelner Shorts gehören zu Videos, wenn Sie sie direkt abrufen möchten.
  2. Senden Sie urls und results_limit per POST an /v1/youtube/shorts und berücksichtigen Sie dabei das Limit für jeden Kanal.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis das Kanalinventar abgeschlossen ist.
  4. 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=50

Anwendungsfä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.

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.

Weitere Plattformen entdecken

Kombinieren Sie YouTube-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

YouTube Shorts API — FAQ

YouTube Shorts API sammelt öffentlich zugängliche Shorts aus einer oder mehreren YouTube-Kanal-URLs. Die Schnittstelle liefert normalisierte Titel, Kanalinformationen, Vorschaubilder, Dauer, Veröffentlichungsdaten, Interaktionskennzahlen und den Zeitpunkt der Erfassung.

Senden Sie eine oder mehrere öffentliche YouTube-Kanal-URLs und optional ein results_limit.

Der Endpunkt folgt der Einstufung von Shorts durch YouTube und nutzt nicht nur eine feste Regel zu Dauer oder Seitenverhältnis.

results_limit hat den Standardwert 100 und gilt separat für jede Kanal-URL. Die Gesamtzahl kann niedriger ausfallen, wenn ein Kanal weniger infrage kommende öffentliche Shorts hat.

Nein. Aufrufe, „Gefällt mir“-Angaben und Kommentare sind öffentliche Werte zum Zeitpunkt der Erfassung. Für historische Vergleiche sind wiederholte Abrufe nötig.

Die Nutzung kostet 0,5 Credits für jedes zurückgegebene normalisierte Short-Ergebnis.