youtube/
search-channels

YouTube-Kanäle per Keyword suchen und Kanal-IDs, Namen, Abonnentenzahlen, Avatare und den von YouTube angezeigten Beschreibungsauszug erhalten, in der Reihenfolge der Suche.

YouTube Channel Search API

Keyword als Eingabe
Abonnentenzahlen
Bis zu 200 Kanäle
0,6 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 Channel Search

Ergebnisse der Kanalsuche sind die Creator-Konten, die YouTube einem Keyword zuordnet, jeweils mit Name, Avatar, Abonnentenzahl und den ersten Zeilen der Kanalbeschreibung. Sie durchzusehen ist der schnellste Weg, um abzuschätzen, wer ein Thema abdeckt, große von aufstrebenden Kanälen zu unterscheiden und eine erste Liste für Creator-Recherche oder Kontaktaufnahme zusammenzustellen.

Funktionen der YouTube Channel Search API

  • Ausschließlich KanäleDie Suche ist auf Kanäle beschränkt, sodass ein Keyword wie home cooking Creator-Konten liefert statt einer Mischung aus Videos und Playlists.
  • Abonnentenzahl pro Kanalmetrics.followers_count enthält die Gesamtzahl der Abonnenten, gelesen aus der Anzeige von YouTube, etwa „3.69M“.
  • Stabile Kanal-IDs und LinksJedes Ergebnis enthält die UC-Kanal-ID und eine daraus gebildete Kanal-URL, bereit für Endpunkte auf Kanalebene.
  • Auszug aus der Beschreibungtext enthält den Beschreibungsauszug aus der Suche, der oft die Nische nennt oder einen geschäftlichen Kontakt enthält.

Parameter der YouTube Channel Search API

ParameterErforderlichBeschreibung
queryErforderlichDas Keyword, zu dem Kanäle gesucht werden, bis zu 100 Zeichen.
results_limitOptionalWie viele Kanäle zurückgegeben werden, von 1 bis 200. Standardwert ist 20.

So verwenden Sie die YouTube Channel Search API

Suchen Sie mit einem Keyword und blättern Sie durch die passenden Kanäle.

  1. Senden Sie {"query": "home cooking", "results_limit": 20} per POST an /v1/youtube/search-channels.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die Kanäle aus results.items und übergeben Sie results.next_cursor erneut, solange has_more den Wert true hat.
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}'

# Each item is one channel with name, text and metrics.followers_count.

Anwendungsfälle der YouTube Channel Search API

  • Eine Creator-Shortlist aufbauen: Suchen Sie nach den Keywords Ihrer Nische und behalten Sie die Kanäle, deren followers_count in der Größenordnung liegt, mit der Sie arbeiten.
  • Sehen, wer ein Thema besetzt: Vergleichen Sie die Abonnentenzahlen der Top-Ergebnisse zu einem Keyword, um einzuschätzen, ob einige wenige große Kanäle es dominieren.
  • Kanalrecherche anstoßen: Übergeben Sie die zurückgegebenen Kanal-URLs an YouTube Channels und YouTube Channel Videos, um jeden Creator eingehend zu analysieren.

Profi-Tipps zur YouTube Channel Search API

  • Abonnentenzahlen stammen aus gerundetem Anzeigetext; verwenden Sie YouTube Channels, wenn Sie die exakte Zahl benötigen.
  • Führen Sie mehrere Formulierungen eines Themas aus und führen Sie die Ergebnisse nach der id des Kanals zusammen, um die Liste zu erweitern.
  • Übergeben Sie vielversprechende Kanäle an YouTube Email Finder, um zu sehen, ob sie einen geschäftlichen Kontakt veröffentlichen.

Ergänzend zur YouTube Channel Search 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 Channels API — Öffentliche Kanalidentität, Bilder, Verifizierung und sichtbare Statistiken zur Zielgruppe abrufen.
  • YouTube Search API — Öffentliche reguläre Videos per Keyword suchen – mit unterstützten Metadatenfiltern.
  • YouTube Hashtag Search API — Öffentliche Videos aus Hashtag-Feeds finden – wahlweise alle Inhalte oder nur Shorts.
  • YouTube Shorts Search API — Shorts per Keyword suchen – mit Links, Beschreibungen, Aufrufzahlen und Vorschaubildern im Hochformat.
  • YouTube Email Finder API — Öffentliche geschäftliche E-Mail-Adressen zu einer Kanal-URL finden – mit den Seiten, auf denen jede Adresse erscheint.

Weitere Plattformen entdecken

Kombinieren Sie YouTube-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

YouTube Channel Search API — FAQ

YouTube Channel Search API ist eine Schnittstelle zum Finden von YouTube-Kanälen, die zu einem Keyword passen. Sie liefert Kanal-IDs, Namen, Abonnentenzahlen, Avatare und Beschreibungsauszüge in der Suchreihenfolge von YouTube.

Setzen Sie results_limit auf einen Wert von 1 bis 200; Standardwert ist 20. Die Ergebnisse werden automatisch Seite für Seite abgerufen, bis das Limit oder das Ende der Ergebnisse von YouTube erreicht ist.

Suchergebnisse kennzeichnen Kanäle über ihre UC-Kanal-ID und die Kanal-URL. Senden Sie diese URL an YouTube Channels, um das Handle und das vollständige Profil zu erhalten.

Nein. Anfragen nutzen Ihren SocQ-API-Schlüssel und werden in Credits pro zurückgegebenem Kanal abgerechnet, sodass Sie weder ein Google-Cloud-Projekt noch ein tägliches Kontingent verwalten müssen.

Jeder zurückgegebene Kanal kostet 0,6 Credits, die standardmäßigen 20 Kanäle kosten also 12 Credits.