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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche öffentliche YouTube-Kanal-URLs, getrennt durch Kommas oder Zeilenumbrüche. Unterstützte Pfade beginnen mit @handle, /channel/, /c/ oder /user/. |
results_limit | Optional | Maximale 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.
- Bereiten Sie vollständige öffentliche YouTube-Kanal-URLs mit einem Pfad aus @handle, /channel/, /c/ oder /user/ vor.
- Senden Sie urls und ein results_limit von 20 bis 2000 per POST an /v1/youtube/community-posts.
- 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.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.
- YouTube Comments API
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API