YouTube Shorts Search
I risultati della ricerca di Shorts sono i video verticali che YouTube posiziona per una parola chiave nel filtro Shorts, ciascuno mostrato con didascalia, numero di visualizzazioni e miniatura 9:16. Osservarli insieme mostra quali hook e angolazioni conquistano l’attenzione su un argomento e ti fornisce una serie di link agli Shorts da studiare o monitorare in seguito.
Funzionalità della YouTube Shorts Search API
- Solo ShortsI risultati provengono dalla ricerca Shorts di YouTube, quindi l’elenco comprende esclusivamente Shorts, senza video lunghi, canali o playlist.
- Didascalia, visualizzazioni e miniaturatext è la didascalia dello Short, metrics.views_count viene ricavato dal conteggio mostrato e media contiene la miniatura verticale con le sue dimensioni.
- Hashtag dalla didascaliaI tag scritti nella didascalia sono elencati in hashtags, pronti per essere contati su un insieme di risultati.
- Link agli Shorts pronti all’usoOgni risultato riporta un URL youtube.com/shorts/ e l’ID del video per ricerche successive.
Parametri della YouTube Shorts Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | La parola chiave con cui cercare gli Shorts, fino a 100 caratteri. |
results_limit | Facoltativo | Quanti Shorts restituire, da 1 a 200. Il valore predefinito è 25. |
Come usare la YouTube Shorts Search API
Cerca con una parola chiave e leggi gli Shorts corrispondenti.
- Invia con POST {"query": "meal prep", "results_limit": 25} a /v1/youtube/search-shorts.
- Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
- Leggi gli Shorts da results.items e segui results.next_cursor finché has_more è true.
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}'
# Each item is one Short with text, metrics.views_count and a shorts URL.Casi d’uso della YouTube Shorts Search API
- Studiare gli hook per un argomento: Leggi le didascalie degli Shorts più visti per una parola chiave per capire quali aperture e promesse attirano visualizzazioni.
- Monitorare una parola chiave negli Shorts: Ripeti la stessa ricerca a intervalli regolari e confronta quali ID video entrano o escono dai risultati.
- Raccogliere Shorts per un’analisi approfondita: Raccogli gli URL degli Shorts di un tema e passali a YouTube Videos per i dettagli su canale, Mi piace e data di pubblicazione.
Consigli degli esperti per la YouTube Shorts Search API
- I risultati di ricerca riportano solo didascalia e numero di visualizzazioni, quindi invia gli URL che conservi a YouTube Videos quando ti servono il canale o i Mi piace.
- Il numero di visualizzazioni deriva da testo arrotondato come 635K; confrontalo come ordine di grandezza e non come totale esatto.
- Le pagine successive ripetono alcuni Shorts delle precedenti, quindi i risultati vengono deduplicati per ID video prima di essere conteggiati in results_limit.
API correlate
Oltre alla YouTube Shorts Search API, usa queste API quando ti serve un altro tipo di dati pubblici di YouTube.
- YouTube Comments API — Raccoglie commenti pubblici, autori, engagement, video di origine e contesto della conversazione.
- YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
- 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 Related Videos API — Elenca i video consigliati accanto all’URL di un video, con titoli, canali, visualizzazioni e miniature.
- YouTube Channel Search API — Trova canali per parola chiave, con nomi, numero di iscritti, avatar ed estratti della descrizione.
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels 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 Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API