YouTube Search Suggestions
Suchvorschläge sind die Ergänzungen, die das YouTube-Suchfeld anbietet, während ein Zuschauer noch tippt, geordnet für dessen Sprache und Land. Sie zeigen, wie die Nachfrage rund um einen Ausgangsbegriff tatsächlich formuliert wird, und sind damit eine direkte Quelle für Keyword-Recherche, Videotitel, Tags und Content-Ideen.
Funktionen der YouTube Search Suggestions API
- Die Reihenfolge, die Zuschauer sehenrank hält die Position jedes Vorschlags in der Auswahlliste fest, beginnend bei 1 für die oberste Ergänzung.
- Markt wählenlanguage und region schalten die Vorschläge auf einen anderen Markt um, zum Beispiel es und MX für Suchen auf mexikanischem Spanisch.
- Ein Suchlink pro BegriffJeder Vorschlag enthält die URL der YouTube-Suchergebnisse für diesen Begriff, zusammen mit der Ausgangsanfrage und dem Markt, mit denen er angefordert wurde.
Parameter der YouTube Search Suggestions API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Der Anfang einer Suche, der ergänzt werden soll, bis zu 100 Zeichen. |
language | Optional | Sprachcode für die Vorschläge, zum Beispiel en, es oder pt-BR. Standardwert ist en. |
region | Optional | Zweistelliger Ländercode des Suchmarkts, zum Beispiel US oder GB. Standardwert ist US. |
So verwenden Sie die YouTube Search Suggestions API
Senden Sie den Anfang einer Suche und lesen Sie die Ergänzungen in ihrer Rangfolge aus.
- Senden Sie {"query": "iphone 17"} per POST an /v1/youtube/search-suggestions und ergänzen Sie language und region für einen anderen Markt.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Vorschläge in der Reihenfolge ihres Rangs aus results.items; folgen Sie results.next_cursor, solange has_more den Wert true hat.
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"}'
# Each item is one suggestion: keyword, rank, language and region.Anwendungsfälle der YouTube Search Suggestions API
- Einen Ausgangsbegriff erweitern: Erfassen Sie die Ergänzungen zu einem Produkt- oder Themennamen, um die längeren Formulierungen zu finden, nach denen Zuschauer tatsächlich suchen.
- Titel schreiben, die zur Suche passen: Übernehmen Sie Formulierungen aus den obersten Vorschlägen, damit ein Videotitel widerspiegelt, wie Menschen die Suchanfrage eintippen.
- Nachfrage in verschiedenen Märkten vergleichen: Führen Sie denselben Ausgangsbegriff mit unterschiedlichen Werten für language und region aus, um zu sehen, wie sich die Suchintention von Land zu Land verschiebt.
Profi-Tipps zur YouTube Search Suggestions API
- Hängen Sie einen Buchstaben an den Ausgangsbegriff an, etwa iphone 17 a, um Ergänzungen zu erhalten, die mit diesem Buchstaben weitergehen.
- Halten Sie language und region konstant, wenn Sie einen Ausgangsbegriff über die Zeit verfolgen, denn jeder Markt liefert seine eigene Liste.
Verwandte APIs
Ergänzend zur YouTube Search Suggestions 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 Comments API — Öffentliche Kommentare, Autoren, Interaktionen, Quellvideos und Gesprächskontext erfassen.
- 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 Channel Search API — Kanäle per Keyword finden – mit Namen, Abonnentenzahlen, Avataren und Beschreibungsauszügen.
- YouTube Shorts Search API — Shorts per Keyword suchen – mit Links, Beschreibungen, Aufrufzahlen und Vorschaubildern im Hochformat.
- YouTube Transcripts API
- YouTube Channels API
- YouTube Videos API
- YouTube Shorts API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Email Finder API
- YouTube Trending Videos API