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ückgegebenetask_id, fragen SieGET /v1/tasks/{task_id}ab, bisstatusden Wertsucceededhat, und lesen Sie danndata.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.
| Endpunkt | Rückgabe | Preis |
|---|---|---|
| YouTube Trending Shorts API | Eine aktuelle Stichprobe trendender Shorts mit Kanal, Aufrufen, Likes, Kommentaren, Länge und Veröffentlichungszeit | 0,5 Credits ($0,0025) pro Short |
| YouTube Shorts Search API | Shorts zu einem Keyword mit Link, Bildunterschrift, Aufrufen und vertikalem Vorschaubild | 0,6 Credits ($0,003) pro Short |
| YouTube Channel Search API | Kanäle zu einem Keyword mit ID, Name, Abonnenten, Avatar und Ausschnitt der Beschreibung | 0,6 Credits ($0,003) pro Kanal |
| YouTube Search Suggestions API | Gerankte Autocomplete-Vorschläge für eine unvollständige Suchanfrage, nach Sprache und Region | 0,5 Credits ($0,0025) pro Aufruf |
| YouTube Community Post API | Ein Community-Beitrag: vollständiger Text, alle Bilder, Likes und Kanal | 0,5 Credits ($0,0025) pro Aufruf |
| YouTube Community Post Comments API | Kommentare unter einem Community-Beitrag mit Kommentierendem, Likes und Antwortzahl | 0,3 Credits ($0,0015) pro Kommentar |
| YouTube Related Videos API | Die Videos, die YouTube neben einem Video empfiehlt | 0,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 wurden | 15 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.
Warum liefern zwei Durchläufe von Trending Shorts unterschiedliche Shorts?
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