youtube/
community-posts

Öffentliche YouTube-Community-Beiträge aus Kanal-URLs sammeln – mit Beitragstext, Kanalidentität, Zeitstempeln, Bildverweisen und Quellkontext als normalisierte Datensätze.

YouTube Community Posts API

Community-Tab
Eingabe per Kanal-URL
Bildverweise
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 Community Posts

YouTube-Community-Beiträge sind öffentliche Updates im Community-Tab eines Kanals, mit Beitragstext, Identität des veröffentlichenden Kanals, Veröffentlichungszeit, öffentlichen Links und angehängten Bildern. Diese Datensätze unterstützen Bestandsaufnahmen von Kanal-Feeds, die Prüfung von Ankündigungen und kanalübergreifende Analysen des Veröffentlichungsverhaltens.

Funktionen der YouTube Community Posts API

  • URL-Sammlung über mehrere KanäleAkzeptiert vollständige öffentliche Kanal-URLs mit den Pfaden @handle, /channel/, /c/ oder /user/ und wendet die gewählte Ergebnisobergrenze für jeden Kanal unabhängig an.
  • Normalisierte BeitragsdatensätzeLiefert öffentliche Beitrags-IDs, Community-URLs, Text sowie Zeitstempel der Veröffentlichung und der Erfassung in einer einheitlichen Struktur.
  • Kontext von Kanal zu BeitragHält jeden Beitrag mit Kanal-ID, Handle, Anzeigename, öffentlicher Kanal-URL und der übergebenen Quell-URL verbunden.
  • Verweise auf angehängte BilderÜberführt verfügbare Beitragsbilder in normalisierte Medieneinträge, damit bildbasierte Updates mit ihren Beitragsdatensätzen verbunden bleiben.
  • Begrenzter Durchlauf des FeedsFolgt den Fortsetzungsseiten der Quelle pro Kanal, entfernt doppelte Beiträge anhand von ID oder URL und stoppt am gewählten Limit, am Ende des Feeds oder an der Obergrenze von 100 Seiten.

Parameter der YouTube Community Posts API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche öffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. Unterstützte Pfade beginnen mit @handle, /channel/, /c/ oder /user/.
results_limitOptionalMaximale Anzahl an Community-Beiträgen, die für jeden eingegebenen Kanal gesammelt werden. Der Standardwert ist 100; zulässig sind ganze Zahlen von 20 bis 2000.

So verwenden Sie die YouTube Community Posts API

Senden Sie einen oder mehrere bekannte öffentliche Kanäle als asynchrone Aufgabe und lesen Sie nach dem Abschluss die gespeicherten Community-Beitragsdatensätze.

  1. Bereiten Sie vollständige öffentliche YouTube-Kanal-URLs mit einem Pfad aus @handle, /channel/, /c/ oder /user/ vor.
  2. Senden Sie urls und ein results_limit von 20 bis 2000 per POST an /v1/youtube/community-posts.
  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/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/@YouTube"],"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 Community Posts API

  • Bestandsaufnahme des Community-Feeds von Kanälen: Bauen Sie aus Beitrags-IDs, URLs, Text, Zeitstempeln und Kontext des Quellkanals einen prüfbaren Feed aus ausgewählten öffentlichen Kanälen auf.
  • Prüfung von Ankündigungen und Creatives: Prüfen Sie öffentliche Beitragstexte zusammen mit den gespeicherten Bildverweisen, um zu vergleichen, wie Kanäle Neuigkeiten außerhalb ihrer Video-Feeds präsentieren.
  • Kanalübergreifende Analyse des Veröffentlichungsverhaltens: Gruppieren Sie normalisierte Beiträge nach Kanalidentität und Veröffentlichungszeit, um die Aktivität in der Community über eine bekannte Kanalgruppe hinweg zu vergleichen.

Profi-Tipps zur YouTube Community Posts API

  • Senden Sie eine vollständige Kanal-URL auf einem unterstützten YouTube-Host; Video-, Beitrags- und Playlist-URLs sowie bloße Werte ohne URL verletzen die Spezifikation der öffentlichen Kanaleingabe.
  • Dimensionieren Sie Anfragen mit mehreren Kanälen bewusst, denn results_limit gilt für jede URL: Drei Kanäle mit 20 können bis zu 60 gespeicherte Beiträge anfordern.
  • Behandeln Sie results_limit als Obergrenze, denn ein Kanal ohne öffentlichen Community-Tab oder mit einem kürzeren sichtbaren Feed kann weniger Datensätze liefern.
  • Verwenden Sie cursor nur mit GET /v1/tasks/{task_id}; die Fortsetzung bei der Quelle wird intern gehandhabt und ist für diesen Endpunkt kein öffentlicher Anfrageparameter.
  • Entfernen Sie Duplikate bei gespeicherten Datensätzen anhand der Beitrags-ID, ersatzweise anhand der URL, und behalten Sie extra.input_url, wenn mehrere übergebene Kanäle zusammengeführt werden.
  • Prüfen Sie text, media und created_at, bevor Sie die Daten weiterverwenden; die aktuellen normalisierten Datensätze enthalten weder Umfrageoptionen noch Metadaten zu eingebetteten Video-Anhängen.

Ergänzend zur YouTube Community Posts 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 Community Post API — Einen Community-Beitrag über seinen Link auslesen – mit vollständigem Text, angehängten Bildern, „Gefällt mir“-Angaben und veröffentlichendem Kanal.
  • 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 Community Posts API — FAQ

YouTube Community Posts API ist eine Schnittstelle zum Sammeln öffentlicher Beiträge aus dem Community-Tab unterstützter YouTube-Kanal-URLs. Sie liefert Beitrags-IDs, URLs, Text, Kanalidentität, Zeitstempel, Bildverweise und Kontext des Quellkanals.

Verwenden Sie vollständige youtube.com-Kanal-URLs, deren erstes Pfadsegment @handle, /channel/, /c/ oder /user/ ist. URLs von Videos, Beiträgen, Playlists und fremden Hosts werden als Kanaleingaben nicht akzeptiert.

results_limit hat den Standardwert 100, akzeptiert ganze Zahlen von 20 bis 2000 und gilt separat für jede übergebene Kanal-URL. Zwei Kanäle mit 100 können daher bis zu 200 gespeicherte Beitragsdatensätze anfordern.

Ein Datensatz kann Beitrags-ID und URL, öffentlichen Text, Kanal-ID, Handle, Name und URL, normalisierte Zählerfelder, gespeicherte Bildverweise, Veröffentlichungs- und Erfassungszeit sowie extra.input_url enthalten.

Verfügbare Bilder können als normalisierte Medienverweise gespeichert werden. Das aktuelle Antwortschema enthält weder Umfrageoptionen noch Stimmenanteile oder Details zu eingebetteten Video-Anhängen.

Nein. Er liefert die öffentlichen Community-Beitragsdatensätze selbst und erweitert die darunterliegenden Kommentar-Threads nicht.

Der Kanal hat möglicherweise keinen öffentlichen Community-Tab, sein sichtbarer Feed kann vor results_limit enden, oder Beiträge können gelöscht, nur für Mitglieder sichtbar, privat oder nur nach Anmeldung zugänglich sein.

Nein. Der Collector folgt den Fortsetzungs-Tokens der Quelle für jeden Kanal intern. Der Cursor einer erfolgreichen Aufgabe blättert nur durch normalisierte Datensätze, die bereits für diese Aufgabe gespeichert wurden.

Jeder gespeicherte normalisierte Beitrag kostet 0,5 Credits. Die erste Schätzung multipliziert das results_limit pro Kanal mit der Anzahl der übergebenen URLs, die endgültige Abrechnung richtet sich jedoch nach der tatsächlichen Zahl gespeicherter Datensätze.