youtube/
comment-replies

Öffentliche YouTube-Antworten über eine stabile Video-URL und die ID des übergeordneten Kommentars sammeln – mit Text, Autoren, Interaktion, Zeitstempeln und Thread-Kontext.

YouTube Comment Replies API

Stabile Kommentar-Eingabe
Öffentliche Antworten
Thread-Kontext
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 Comment Replies

Antworten auf YouTube-Kommentare sind öffentliche Beiträge unterhalb eines Kommentars der obersten Ebene, mit Antworttext, Autoridentität, sichtbaren Likes, Veröffentlichungszeit sowie dem Bezug zum übergeordneten Kommentar und zum Video. Diese Thread-Datensätze unterstützen die Rekonstruktion von Unterhaltungen, die Prüfung von Antworten und die Aufbereitung von Datensätzen zu öffentlichen Diskussionen.

Funktionen der YouTube Comment Replies API

  • Stabiler KommentarbezugGehen Sie von einer öffentlichen Video-URL und der ID des übergeordneten Kommentars aus, während SocQ das aktuelle Fortsetzungs-Token für die Antworten intern auflöst.
  • Antwort- und AutorendatensätzeLiefert Antwort-IDs, öffentlichen Text, zugehörige URLs, Veröffentlichungszeiten und normalisierte Autoren- beziehungsweise Kanalidentität.
  • Thread- und Creator-KontextBehält sichtbare Likes, Anzahl verschachtelter Antworten, Verweise auf übergeordneten Kommentar und Video sowie Markierungen für Kanalinhaber oder Creator-Herz zusammen bei.
  • Begrenzte FortsetzungssammlungFolgt den weiteren Fortsetzungs-Tokens der Quelle, entfernt doppelte Antwort-IDs und stoppt am gewählten Limit, bei einem erschöpften Thread oder an der Obergrenze von 100 Seiten.

Parameter der YouTube Comment Replies API

ParameterErforderlichBeschreibung
urlErforderlichErforderliche stabile öffentliche YouTube-Video-URL, die den übergeordneten Kommentar enthält.
comment_idErforderlichErforderliche ID des Kommentars der obersten Ebene, der zur übergebenen Video-URL gehört.
results_limitOptionalMaximale Anzahl öffentlicher Antworten, die aus diesem Thread gesammelt werden. Das dokumentierte Beispiel verwendet 20, der zulässige Bereich reicht von 20 bis 2000.

So verwenden Sie die YouTube Comment Replies API

Senden Sie eine stabile Video-URL und die ID des übergeordneten Kommentars als asynchrone Aufgabe und lesen Sie die normalisierten Antwortdatensätze aus der abgeschlossenen Aufgabe.

  1. Wählen Sie eine öffentliche YouTube-Video-URL und die ID eines Kommentars der obersten Ebene, der für dieses Video zurückgegeben wurde.
  2. Senden Sie url, comment_id und results_limit per POST an /v1/youtube/comment-replies.
  3. Bewahren Sie die zurückgegebene task_id auf und fragen Sie GET /v1/tasks/{task_id} ab, solange die Aufgabe queued, running oder retrying ist.
  4. Lesen Sie nach einem Erfolg data.results.items und übergeben Sie data.results.next_cursor als cursor in der Aufgabenanfrage, solange data.results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass data.results.next_cursor as cursor while has_more is true

Anwendungsfälle der YouTube Comment Replies API

  • Rekonstruktion bekannter Threads: Verbinden Sie gespeicherte Antworten über Antwort-IDs, parent_comment_id, video_id, URLs und Zeitstempel wieder mit einem ausgewählten Kommentar der obersten Ebene.
  • Prüfung der Zielgruppe auf Antwortebene: Vergleichen Sie innerhalb eines bekannten Threads öffentliche Antworttexte, Autoridentität, sichtbare Likes, Anzahl verschachtelter Antworten und Markierungen für Interaktionen des Creators.
  • Aufbereitung von Datensätzen zu öffentlichen Diskussionen: Fassen Sie normalisierte Antworttexte, Autoren, Zeitstempel und Thread-Kontext zu Datensätzen für die manuelle Prüfung oder die nachgelagerte Textverarbeitung zusammen.

Profi-Tipps zur YouTube Comment Replies API

  • Halten Sie Video-URL und die ID des Kommentars der obersten Ebene als Paar zusammen, damit Antwort-Thread und Quellvideo aufeinander abgestimmt bleiben.
  • SocQ löst das aktuelle Fortsetzungs-Token intern auf; wiederholen Sie die Anfrage mit demselben stabilen Bezug, wenn ein Token der Quelle abläuft.
  • Halten Sie die ID des Quellkommentars getrennt vom Cursor, den GET /v1/tasks/{task_id} zurückgibt; die eine wählt einen YouTube-Antwort-Thread aus, der andere blättert durch gespeicherte Aufgabenergebnisse.
  • Setzen Sie results_limit auf die erwartete Thread-Größe, behandeln Sie es aber als Obergrenze, denn öffentliche Sichtbarkeit und ein erschöpfter Thread können die zurückgegebene Anzahl verringern.
  • Entfernen Sie Duplikate bei gespeicherten Datensätzen anhand der Antwort-ID und behalten Sie parent_comment_id, video_id und extra.reply_token, wenn Sie Antworten wieder mit ihrem Quellkommentar verknüpfen.
  • Lassen Sie Autor, Zeitstempel, Kennzahlen und Creator-Markierungen als nullable Felder zu und maskieren Sie öffentliche Antworttexte, bevor Sie sie in einer anderen Oberfläche anzeigen.

Ergänzend zur YouTube Comment Replies 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 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 Comment Replies API — FAQ

YouTube Comment Replies API ist eine Schnittstelle zum Sammeln öffentlicher Antworten auf einen Kommentar der obersten Ebene bei YouTube. Senden Sie die stabile Video-URL und die Kommentar-ID, um Antworttext, Autoridentität, sichtbare Interaktion, Zeitstempel und Thread-Kontext zu erhalten.

Führen Sie YouTube Comments API mit einer öffentlichen Video-URL aus und verwenden Sie dann die ID eines passenden Kommentars der obersten Ebene, der für dasselbe Video zurückgegeben wurde.

Nein. SocQ löst das aktuelle Fortsetzungs-Token aus der übergebenen Video-URL und Kommentar-ID auf; die Übergabe eines älteren Tokens bleibt aus Kompatibilitätsgründen in der API möglich, wird in diesem Playground aber nicht verwendet.

results_limit akzeptiert ganze Zahlen von 20 bis 2000, und das dokumentierte Playground-Beispiel sendet 20. Die Sammlung endet an dieser Obergrenze, wenn der öffentliche Thread endet oder nach 100 Quellseiten.

Eine Antwort kann ihre ID, URL, den Text, öffentliche Angaben zu Autor oder Kanal, sichtbare Likes und die Anzahl verschachtelter Antworten, Veröffentlichungs- und Erfassungszeit sowie in extra den Kontext zu Video, übergeordnetem Kommentar, Creator-Markierung und Token enthalten.

Nein. comment_id wählt den YouTube-Antwort-Thread der Quelle aus, während cursor durch normalisierte Datensätze blättert, die bereits unter einer erfolgreich abgeschlossenen SocQ-Aufgabe gespeichert sind.

Der übergeordnete Kommentar stellt möglicherweise kein Antwort-Token bereit, der Thread kann vor results_limit enden, oder Antworten können gelöscht, ausgeblendet, zur Prüfung zurückgehalten, nur für Mitglieder sichtbar, deaktiviert oder anderweitig für die Öffentlichkeit nicht verfügbar sein.

Jede gespeicherte normalisierte Antwort kostet 0,5 Credits. Die Abrechnung richtet sich nach der tatsächlichen Zahl gespeicherter Datensätze, ein leeres Ergebnis verursacht daher keine Kosten pro Ergebnis.