Zurück zu den APIs
Öffentliche YouTube-Daten

YouTube Public Data API

Erfassen Sie unterstützte öffentliche YouTube-Kanalprofile, Videodetails, Kanalvideos, Kommentare, Shorts, Stichwort- und Hashtag-Ergebnisse sowie verfügbare Transkripte in einem einheitlichen, normalisierten asynchronen Ablauf.

Verfügbare YouTube-APIs

Wählen Sie die direkte Abfrage von Kanal oder Video, die kanalbasierte Erfassung von Videos und Shorts, öffentliche Kommentare, die Suche per Stichwort oder Hashtag oder verfügbare Transkripttexte.

Welche YouTube-Daten können Sie abrufen?

SocQ wandelt unterstützte öffentliche YouTube-Ergebnisse in normalisierte Datensätze für Anreicherung, Monitoring, Recherche, Inhaltsanalyse und Reporting um.

Kanalprofile

Rufen Sie Kanalidentität, Beschreibungen, öffentliche Bilder, Verifizierung sowie die sichtbaren Zahlen zu Abonnenten, Videos und Gesamtaufrufen ab.

Metadaten zu Videos und Shorts

Erfassen Sie Titel, Beschreibungen, Kanalkontext, Vorschaubilder, Dauer, Veröffentlichungsangaben und sichtbare Interaktion.

Öffentliche Diskussion

Erfassen Sie öffentlich sichtbare Kommentartexte, Autorenkontext, Likes, Anzahl der Antworten, Videoverweise und die Beziehungen zu übergeordneten Kommentaren.

Suche und Transkripte

Durchsuchen Sie öffentliche reguläre Videos per Stichwort, erfassen Sie Videos aus Hashtag-Feeds und rufen Sie für bekannte URLs verfügbare Untertitelinhalte als reinen Text ab.

SocQ vs YouTube Data API

SocQ konzentriert sich auf die Erfassung unterstützter öffentlicher Daten und auf normalisierte Ergebnisse. Die YouTube Data API ist die richtige Wahl für offizielles OAuth, Kanalverwaltung und autorisierte Funktionen.

FunktionSocQYouTube Data API
HauptzweckErfassung und Normalisierung unterstützter öffentlicher DatenOffizielle Plattformintegration und autorisierte Ressourcen
AuthentifizierungSocQ-API-SchlüsselGoogle-OAuth oder API-Zugangsdaten, je nach Funktion
InhaltsverwaltungErstellt, bearbeitet oder löscht keine YouTube-Inhalte, liked sie nicht, kommentiert sie nicht und verwaltet sie nichtUnterstützt zulässige autorisierte Funktionen
Private oder eingeschränkte DatenNicht unterstütztBegrenzt auf Daten, die die erteilte Autorisierung und die Plattformrichtlinien erlauben
AntwortformatNormalisierte SocQ-DatensätzeNative YouTube-API-Ressourcen

So funktioniert die YouTube API

Alle acht Endpunkte folgen demselben asynchronen Ablauf: senden, abfragen und per Cursor-Paginierung lesen.

  1. 1. Öffentliche Eingaben senden

    Senden Sie per POST unterstützte Kanal-URLs, Video-URLs, eine Stichwortanfrage, Hashtags und endpunktspezifische optionale Filter.

  2. 2. Aufgabe abfragen

    Fragen Sie die zurückgegebene Aufgaben-ID ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt, und warten Sie nach Antworten wegen vorübergehender Überlastung mit zunehmendem Abstand.

  3. 3. Lesen und paginieren

    Lesen Sie die normalisierten Datensätze aus data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.

Mit einer API-Anfrage beginnen

Authentifizieren Sie sich mit einem SocQ-API-Schlüssel. Diese Anfrage ruft ein öffentliches Kanalprofil ab; wählen Sie einen anderen Endpunkt für Videos, Kommentare, Shorts, die Suche per Stichwort oder Hashtag oder für Transkripte.

curl -X POST "https://api.socq.ai/v1/youtube/channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@NASA"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Typische Anwendungsfälle der YouTube API

Creator- und Kanalrecherche

Kombinieren Sie öffentliche Kanalprofile, reguläre Videos und Shorts für die Anreicherung von Verzeichnissen und für Vergleichsanalysen.

Beobachtung von Inhalten und Reaktionen

Verfolgen Sie Metadaten ausgewählter Videos, öffentliche Kommentardiskussionen und Momentaufnahmen der Interaktion zum Erfassungszeitpunkt.

Themenrecherche

Durchsuchen Sie öffentliche Videos per Stichwort oder Hashtag-Feed und reichern Sie dann ausgewählte URLs an oder rufen Sie verfügbare Transkripttexte ab.

Datenpipelines

Leiten Sie normalisierte Datensätze in Data Warehouses, Prüfwerkzeuge, Klassifikatoren, Suchindizes und Reporting-Systeme weiter.

Grenzen und Richtlinie für öffentliche Daten

Öffentliche YouTube-Ergebnisse sind dynamisch und hängen von der aktuellen Sichtbarkeit, der Einstufung, der regionalen Verfügbarkeit und dem öffentlichen Zugriff auf Untertitel und Kommentare ab.

  • Private, gelöschte, nur für Mitglieder verfügbare, regional eingeschränkte, altersbeschränkte und anderweitig nicht zugängliche Inhalte liefern möglicherweise keine Datensätze.
  • Sichtbare Zähler, Suchrankings, Einstufungen, Kommentare und Untertitel können sich nach der Erfassung ändern.
  • Ein angefordertes Ergebnislimit garantiert nicht, dass so viele geeignete öffentliche Datensätze existieren.
  • SocQ ist keine offizielle YouTube-API und verwaltet, erstellt, ändert oder löscht keine YouTube-Inhalte, liked sie nicht und kommentiert sie nicht.

Häufige Fragen zur YouTube API

Ist SocQ die offizielle YouTube-API?

Nein. SocQ erfasst und normalisiert unterstützte öffentliche Ergebnisse. Nutzen Sie die YouTube Data API für offizielles OAuth, Kanalverwaltung und autorisierte Funktionen.

Müssen Nutzer YouTube-Konten verbinden?

Nein, für diese unterstützten Endpunkte mit öffentlichen Daten ist kein YouTube-OAuth des Kunden nötig. Anfragen authentifizieren sich mit einem SocQ-API-Schlüssel.

Welche YouTube-Ressourcen sind verfügbar?

Verfügbar sind Channels, Videos, Channel Videos, Comments, Shorts, Search, Hashtag Search und Transcripts, jeweils mit eigener dokumentierter Eingabe und normalisierter Spezifikation des Ergebnisses.

Wie wird die Nutzung abgerechnet?

Die Karte jedes Endpunkts zeigt den aktuellen Credit-Preis pro Ergebnis, und der Playground schätzt die gesendete Anfrage anhand der Abrechnungsregeln des Endpunkts.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.