youtube/
comments

Öffentlich sichtbare YouTube-Kommentare aus einer oder mehreren Video-URLs sammeln – mit normalisiertem Text, Autoren, Likes, Antwortzahlen, Quellvideos und Gesprächskontext.

YouTube Comments API

Kommentare
Diskussionsdaten
Video-URLs
0,3 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 Comments

YouTube-Kommentare sind öffentliche Reaktionen von Zuschauern auf Videos, mit Text, Autorenkontext, Veröffentlichungszeit, sichtbaren Likes, Antwortzahlen, Angaben zum Quellvideo und Bezügen innerhalb der Unterhaltung. Diese Diskussionssignale unterstützen die Analyse von Feedback, die Zielgruppenforschung, die Prüfung von Themen und die Beobachtung von Reaktionen.

Funktionen der YouTube Comments API

  • Kommentarsammlung über mehrere VideosSammeln Sie öffentliche Kommentare aus mehreren Video-URLs in einer einzigen Anfrage.
  • Limits und Sortierung pro VideoLegen Sie ein results_limit pro Video fest und wählen Sie die Sortierung nach neuesten Kommentaren oder nach Relevanz.
  • Kommentar- und AutorenfelderLiefert Kommentar-ID, Text, öffentliche Autorendetails, Veröffentlichungszeit und Informationen zum Quellvideo.
  • Beziehungen innerhalb von ThreadsEnthält die öffentliche Like-Anzahl, die Anzahl der Antworten und die ID des übergeordneten Kommentars für eine strukturierte Diskussionsanalyse.
  • Indikatoren für Creator-InteraktionBehält die Kennzeichnungen für Kanalinhaber und Creator-Herz bei, wenn sie im öffentlichen Ergebnis vorhanden sind.

Parameter der YouTube Comments API

ParameterErforderlichBeschreibung
urlsErforderlichÖffentliche YouTube-Video-URLs mit sichtbaren Kommentaren, 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.
sort_byOptionalSortierung der Kommentare. Der Standardwert ist newest; relevance verwendet das öffentliche Ranking von YouTube.

So verwenden Sie die YouTube Comments API

Entscheiden Sie, ob Aktualität oder Prominenz zählt, legen Sie ein Stichprobenbudget pro Video fest und behalten Sie die zurückgegebenen Beziehungen bei, wenn Kommentare in Ihre Analyse-Pipeline gelangen.

  1. Wählen Sie öffentliche Video-URLs und legen Sie fest, ob Sie aktuelle Reaktionen oder die von YouTube gerankte Diskussion benötigen.
  2. Senden Sie urls, results_limit und sort_by per POST an /v1/youtube/comments; das Limit gilt für jedes Video.
  3. Fragen Sie /v1/tasks/{task_id} ab; Videos mit aktivierten Kommentaren und nicht verfügbare Kommentarbereiche werden im selben Batch aufgelöst.
  4. Entfernen Sie nach einem Erfolg Duplikate anhand der Kommentar-ID, verknüpfen Sie Antworten über parent_comment_id und paginieren Sie, solange has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'

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

Anwendungsfälle der YouTube Comments API

  • Analyse von Zielgruppen-Feedback: Analysieren Sie öffentliche Kommentartexte, um Stimmungen, wiederkehrende Fragen, Themen und Content-Ideen zu erkennen.
  • Beobachtung von Kampagnen und Veranstaltungen: Verfolgen Sie öffentliche Reaktionen auf Creators, Produkteinführungen, Kampagnen, Ankündigungen oder Veranstaltungen.
  • Diskussionsforschung: Nutzen Sie Likes, Antwortzahlen und Verweise auf übergeordnete Kommentare, um stark beachtete Kommentare und aktive Threads zu untersuchen.
  • Datensätze für die Textanalyse: Stellen Sie normalisierte Kommentare für Workflows zur Klassifizierung, zum Clustering, zur Zusammenfassung, zur Unterstützung der Moderation oder für Benachrichtigungen bereit.

Profi-Tipps zur YouTube Comments API

  • Wählen Sie sort_by vor der Analyse. Ein Wechsel von relevance zu newest verändert die Stichprobe, daher sollten die beiden Exporte nicht verglichen werden, als hätte sich nur ihre Reihenfolge geändert.
  • Behandeln Sie results_limit als Obergrenze pro Video. Deaktivierte Kommentare, Moderation, Ranking, Einschränkungen und geringe Aktivität können die zurückgegebene Anzahl verringern.
  • Nutzen Sie die Kommentar-ID zur Deduplizierung und parent_comment_id zur Verknüpfung, gehen Sie aber nicht davon aus, dass jede sichtbare Antwort auf derselben Ergebnisseite enthalten ist.
  • Likes und Antwortsummen sind Beobachtungen zum Zeitpunkt der Erfassung und kein festes Maß für Stimmung oder Bedeutung.
  • Kommentartext und Autorenfelder sind nicht vertrauenswürdige öffentliche Eingaben. Maskieren Sie sie in Oberflächen und prüfen Sie eingebettete URLs, bevor Sie sie verwenden.
  • Ein Keyword-Treffer ist keine Stimmungsanalyse. Behalten Sie Originaltext und Quellkontext bei, wenn Sie Labels oder Zusammenfassungen anwenden.
  • Behalten Sie in jeder Zeile Video-ID und collected_at bei, damit Analysten nachvollziehen können, welche Gesprächsstichprobe sie geprüft haben.

Ergänzend zur YouTube Comments 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 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 Comment Replies API — Einen bekannten YouTube-Kommentarstrang über sein Antwort-Token fortsetzen und öffentliche Antworten, Autoren, Interaktionen und den Kontext des übergeordneten Kommentars zurückgeben.
  • YouTube Community Post Comments API — Kommentare unter einem Community-Beitrag per Link erfassen – mit Kanälen der Kommentierenden, „Gefällt mir“-Angaben und Antwortzahlen.

Weitere Plattformen entdecken

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

YouTube Comments API — FAQ

YouTube Comments API sammelt öffentlich sichtbare Kommentare aus einer oder mehreren YouTube-Video-URLs. Die Schnittstelle liefert normalisierten Text, Autorendetails, Veröffentlichungszeit, Likes, Antwortzahlen, Verweise auf das Quellvideo, IDs übergeordneter Kommentare und den Zeitpunkt der Erfassung.

Senden Sie eine oder mehrere öffentliche YouTube-Video-URLs, optional ein results_limit und optional einen Wert für sort_by.

Verwenden Sie newest für die neuesten Kommentare zuerst oder relevance für die öffentliche Relevanzreihenfolge von YouTube. newest ist der Standardwert.

Antwortdatensätze können parent_comment_id enthalten, während replies_count die öffentliche Anzahl der Antworten auf einen Kommentar angibt.

results_limit ist ein Höchstwert pro Video. Videos mit deaktivierten, gefilterten, eingeschränkten oder weniger öffentlich sichtbaren Kommentaren können weniger Datensätze oder ein leeres Ergebnis liefern.

Die Nutzung kostet 0,3 Credits für jedes zurückgegebene normalisierte Kommentarergebnis.