YouTubeYouTube ShortsCommunity-BeiträgeCreator-OutreachAPI-Leitfaden

Neue YouTube API Endpunkte: Trend-Shorts, Community-Beiträge, Kanalsuche und E-Mails

Acht neue YouTube-Endpunkte von SocQ liefern Trend-Shorts, Shorts- und Kanalsuche, Suchvorschläge, Community-Beiträge und deren Kommentare, ähnliche Videos und geschäftliche E-Mail-Adressen von Kanälen.

SocQAktualisiert am 19. November 20268 Min. Lesezeit

SocQ lieferte bereits öffentliche YouTube-Kanäle, Videos, Shorts, Kommentare, Suche, Playlists und Transkripte. Die 7 besten YouTube-Scraper-APIs vergleicht diese, und der Leitfaden zu YouTube-Transkripten behandelt Untertiteltexte in großem Umfang. Am 2026-11-17 gingen acht weitere Endpunkte auf der YouTube-Plattformseite live. Sie schließen Lücken bei der Shorts-Recherche, bei der Suche nach Creators und der Kontaktaufnahme sowie bei den Community-Beiträgen, die Creators zwischen ihren Uploads veröffentlichen.

Dieser Leitfaden gruppiert die neuen Endpunkte nach Aufgabe, zeigt für jeden eine Anfrage, nennt den Preis und erklärt, wann er sich eignet.

Kurze Antwort: Senden Sie einen JSON-Body an POST https://api.socq.ai/v1/youtube/<endpoint>. Speichern Sie die zurückgegebene task_id, fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie dann data.results.items.

Die neuen YouTube-Endpunkte im Überblick

1 SocQ-Credit = $0,005. Endpunkte mit Abrechnung pro Ergebnis haben keine Grundgebühr, ein leeres Ergebnis kostet also nichts.

EndpunktRückgabePreis
YouTube Trending Shorts APIEine aktuelle Stichprobe trendender Shorts mit Kanal, Aufrufen, Likes, Kommentaren, Länge und Veröffentlichungszeit0,5 Credits ($0,0025) pro Short
YouTube Shorts Search APIShorts zu einem Keyword mit Link, Bildunterschrift, Aufrufen und vertikalem Vorschaubild0,6 Credits ($0,003) pro Short
YouTube Channel Search APIKanäle zu einem Keyword mit ID, Name, Abonnenten, Avatar und Ausschnitt der Beschreibung0,6 Credits ($0,003) pro Kanal
YouTube Search Suggestions APIGerankte Autocomplete-Vorschläge für eine unvollständige Suchanfrage, nach Sprache und Region0,5 Credits ($0,0025) pro Aufruf
YouTube Community Post APIEin Community-Beitrag: vollständiger Text, alle Bilder, Likes und Kanal0,5 Credits ($0,0025) pro Aufruf
YouTube Community Post Comments APIKommentare unter einem Community-Beitrag mit Kommentierendem, Likes und Antwortzahl0,3 Credits ($0,0015) pro Kommentar
YouTube Related Videos APIDie Videos, die YouTube neben einem Video empfiehlt0,5 Credits ($0,0025) pro Video
YouTube Email Finder APIÖffentliche geschäftliche E-Mail-Adressen eines Kanals und die Seiten, auf denen sie gefunden wurden15 Credits ($0,075) pro Kanal mit E-Mail; kostenlos, wenn keine gefunden wird

Authentifizierung und der asynchrone Aufgabenablauf

Alle Anfragen authentifizieren sich mit einem API-Schlüssel. Derselbe Header wird für Übermittlung, Aufgabenstatus und Ergebnisabruf verwendet:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Jede Erfassung läuft als Hintergrundaufgabe:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Der Übermittlungsaufruf antwortet sofort mit data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Hat status den Wert succeeded, enthält die Antwort result_count, credits_amount und die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und reicht bis 500. Wenn results.has_more true ist, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Eine fehlgeschlagene Aufgabe enthält error_message.

Jeder der folgenden Endpunkte akzeptiert außerdem eine optionale callback_url. SocQ sendet nach Abschluss der Aufgabe einen einzelnen POST mit einer Zusammenfassung; die Datensätze lesen Sie über den Aufgaben-Endpunkt. Eine Zeitüberschreitung beim Client bricht eine Aufgabe nicht ab. Setzen Sie daher mit derselben Aufgaben-ID fort, statt erneut zu übermitteln. Ein 402 bedeutet, dass das Konto keine Credits mehr hat, und ein 429, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.

Shorts und Suchnachfrage recherchieren

Trending Shorts zieht eine Stichprobe der Shorts, die YouTube gerade als Trend ausspielt, jeweils mit Titel, Kanal, Aufrufen, Likes, Kommentaren, Länge und Veröffentlichungszeit. Alle Felder sind optional; results_limit ist standardmäßig 48 und reicht bis 200. Jeder Durchlauf zieht eine neue Stichprobe, sodass zwei Durchläufe im Abstand weniger Minuten nur eine Handvoll Shorts gemeinsam haben. Ein geplanter Job ergibt daher über den Tag ein breiteres Bild als ein einzelner großer Aufruf. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit": 48}'

Shorts Search liefert Shorts zu einem Keyword in der Suchreihenfolge von YouTube, mit Link, Bildunterschrift, Aufrufzahl und vertikalem Vorschaubild. Suchergebnisse enthalten nur diese Grunddaten. Übergeben Sie die behaltenen Links daher an YouTube Videos, wenn Sie auch Likes, Kommentare oder Kanaldetails brauchen. results_limit ist standardmäßig 25 (1 bis 200). (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/search-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "meal prep", "results_limit": 25}'

Search Suggestions liefert die Vervollständigungen, die das YouTube-Suchfeld für den Anfang einer Suchanfrage vorschlägt, in der Reihenfolge, die Zuschauer sehen. language ist standardmäßig en und region standardmäßig US; ändern Sie beide, um zu sehen, wie sich derselbe Ausgangsbegriff in einem anderen Markt verzweigt. Jeder Aufruf wird einmal berechnet, unabhängig von der Zahl der Vorschläge. Nutzen Sie ihn für Keyword-Recherche, Titel und Tags. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "iphone 17"}'

Creators finden und ihre Kontakt-E-Mail ermitteln

Channel Search findet Kanäle zu einem Keyword in der Reihenfolge von YouTube, mit Kanal-ID, Name, Abonnentenzahl, Avatar und dem in den Ergebnissen angezeigten Ausschnitt der Beschreibung. results_limit ist standardmäßig 20 (1 bis 200). Das ist der erste Schritt bei der Suche nach Creators: Hier erstellen Sie die Shortlist und rufen dann Details mit YouTube Channels oder Uploads mit YouTube Channel Videos ab. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/search-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "home cooking", "results_limit": 20}'

Email Finder sucht die geschäftlichen E-Mail-Adressen, die ein Creator veröffentlicht hat: in der Kanalbeschreibung, auf verknüpften Social-Media-Profilen, Link-in-Bio-Seiten oder der eigenen Website des Creators. Jede Adresse in emails kommt mit den source_urls, auf denen sie gefunden wurde. url erwartet einen Kanallink im Format @handle oder /channel/UC.... Ein Kanal mit mindestens einer öffentlichen E-Mail-Adresse liefert ein Ergebnis mit allen gefundenen Adressen und kostet 15 Credits ($0,075); ein Kanal ohne Adresse liefert ein leeres Ergebnis ohne Kosten. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/channel-email" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/@mkbhd"}'

Kostenbeispiel: Suchen Sie 20 Kanäle (12 Credits) und führen Sie dann Email Finder für alle 20 aus. Wenn 8 eine E-Mail-Adresse angeben, sind das 120 Credits, insgesamt also 132 Credits ($0,66). Für die 12 Kanäle ohne öffentliche E-Mail-Adresse zahlen Sie nichts.

Community-Beiträge und ihre Kommentare lesen

Community Post liest einen Beitrag über seinen Link: vollständiger Text, alle angehängten Bilder, Like-Zahl und der veröffentlichende Kanal. url erwartet einen Link https://www.youtube.com/post/{post_id} oder einen Link zum Beiträge-Tab eines Kanals mit ?lb={post_id}. Nutzen Sie ihn, wenn Sie bereits eine Beitrags-URL haben, zum Beispiel aus einem Ergebnis von YouTube Community Posts. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/community-post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8"}'

Community Post Comments sammelt die Kommentare unter einem Beitrag, etwa einer Umfrage, einer Ankündigung oder einem Bild, mit dem Kanal jedes Kommentierenden, metrics.likes_count und metrics.replies_count. Kommentare zu Beiträgen sind von Videokommentaren getrennt. So lesen Sie die Reaktion auf die Updates eines Creators zwischen seinen Uploads. Es gelten dieselben URL-Formate; results_limit ist standardmäßig 100 (1 bis 1000). (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/community-post-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", "results_limit": 100}'

Sehen, was YouTube als Nächstes empfiehlt

Related Videos liefert die Liste, die YouTube neben einem Video als nächste Empfehlung anzeigt: Titel, Kanäle, Aufrufzahlen und Vorschaubilder. url erwartet einen Watch-, youtu.be-, Shorts- oder Live-Link. Ein Durchlauf liefert die gesamte Empfehlungsliste, meist etwa 20 Videos, abgerechnet pro Video. Ein typischer Aufruf kostet also etwa 10 Credits ($0,05). Führen Sie ihn für Ihre eigenen Uploads oder die eines Wettbewerbers aus, um zu sehen, welche Videos und Kanäle YouTube als deren Nachbarn behandelt. (Doku)

curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

Verwandte YouTube-Leitfäden

Für einen Vergleich von SocQ mit anderen YouTube-Datenanbietern siehe Die 19 besten Alternativen zur YouTube API. Denselben Ablauf zur Creator-Suche und Kontaktaufnahme für TikTok, einschließlich Follower-Ländern und Prüfungen auf gefälschte Aufrufe, finden Sie im Leitfaden zu den neuen TikTok-Endpunkten.

FAQ

Zahle ich für Kanäle ohne öffentliche E-Mail-Adresse?

Nein. Ein Kanal ohne öffentliche E-Mail-Adresse liefert ein leeres Ergebnis, das kostenlos ist. Ein Kanal mit mindestens einer E-Mail-Adresse kostet 15 Credits, unabhängig davon, wie viele Adressen er angibt.

Jeder Durchlauf zieht eine Stichprobe dessen, was in diesem Moment trendet. Durchläufe im Abstand weniger Minuten haben daher nur eine Handvoll Shorts gemeinsam. Planen Sie mehrere Durchläufe ein, wenn Sie eine breitere Abdeckung möchten.

Welche URLs von Community-Beiträgen werden akzeptiert?

https://www.youtube.com/post/{post_id} oder ein Link zum Beiträge-Tab eines Kanals mit ?lb={post_id}.

Liefert Shorts Search Likes und Kommentare?

Nein. Suchergebnisse enthalten Link, Bildunterschrift, Aufrufzahl und Vorschaubild. Übergeben Sie die Links an YouTube Videos, um Likes, Kommentare und Kanaldetails zu erhalten.

Wie wird Search Suggestions abgerechnet?

0,5 Credits pro Aufruf, unabhängig von der Zahl der zurückgegebenen Vorschläge.

YOUTUBE API

Workflow mit einer öffentlichen YouTube-URL testen

Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.

YouTube-APIs ansehen