YouTube Search Suggestions
I suggerimenti di ricerca sono i completamenti che la barra di ricerca di YouTube propone mentre uno spettatore sta ancora digitando, ordinati in base alla sua lingua e al suo paese. Rivelano le formulazioni reali della domanda attorno a un termine di partenza, quindi sono una fonte diretta per la ricerca di parole chiave, i titoli dei video, i tag e le idee per i contenuti.
Funzionalità della YouTube Search Suggestions API
- L’ordine visto dagli spettatorirank registra la posizione di ogni suggerimento nel menu a discesa, a partire da 1 per il primo completamento.
- Scegli il mercatolanguage e region spostano i suggerimenti su un altro mercato, per esempio es e MX per le ricerche in spagnolo messicano.
- Un link di ricerca per ogni fraseOgni suggerimento include l’URL dei risultati di YouTube per quella frase, insieme alla query di partenza e al mercato con cui è stato richiesto.
Parametri della YouTube Search Suggestions API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | L’inizio di una ricerca da completare, fino a 100 caratteri. |
language | Facoltativo | Codice della lingua dei suggerimenti, per esempio en, es o pt-BR. Il valore predefinito è en. |
region | Facoltativo | Codice di due lettere del paese del mercato di ricerca, per esempio US o GB. Il valore predefinito è US. |
Come usare la YouTube Search Suggestions API
Invia l’inizio di una ricerca e leggi i completamenti in ordine di posizione.
- Invia con POST {"query": "iphone 17"} a /v1/youtube/search-suggestions, aggiungendo language e region per un altro mercato.
- Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
- Leggi i suggerimenti da results.items in ordine di rank; segui results.next_cursor finché has_more è true.
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.Casi d’uso della YouTube Search Suggestions API
- Espandere una parola chiave di partenza: Raccogli i completamenti per il nome di un prodotto o di un argomento per trovare le frasi più lunghe che gli spettatori cercano davvero.
- Scrivere titoli in linea con la ricerca: Scegli le parole dai suggerimenti nelle prime posizioni, così il titolo di un video rispecchia il modo in cui le persone digitano la query.
- Confrontare la domanda tra mercati: Esegui la stessa parola di partenza con valori diversi di language e region per vedere come cambia l’intento da un paese all’altro.
Consigli degli esperti per la YouTube Search Suggestions API
- Aggiungi una lettera dopo la parola di partenza, per esempio iphone 17 a, per ottenere completamenti che proseguono con quella lettera.
- Mantieni costanti language e region quando monitori una parola di partenza nel tempo, perché ogni mercato restituisce il proprio elenco.
API correlate
Oltre alla YouTube Search Suggestions API, usa queste API quando ti serve un altro tipo di dati pubblici di YouTube.
- YouTube Channel Videos API — Raccoglie i video pubblici regolari dagli URL dei canali, esclusi Shorts e dirette.
- YouTube Comments API — Raccoglie commenti pubblici, autori, engagement, video di origine e contesto della conversazione.
- YouTube Search API — Cerca video pubblici regolari per parola chiave con filtri sui metadati supportati.
- YouTube Hashtag Search API — Trova video pubblici dai feed degli hashtag, raccogliendo tutti i contenuti oppure solo gli Shorts.
- YouTube Channel Search API — Trova canali per parola chiave, con nomi, numero di iscritti, avatar ed estratti della descrizione.
- YouTube Shorts Search API — Cerca Shorts per parola chiave, con link, didascalie, numero di visualizzazioni e miniature verticali.
- 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