youtube/
search-shorts

Cerca gli Shorts di YouTube per parola chiave e ottieni link, didascalia, numero di visualizzazioni, miniatura verticale e hashtag della didascalia di ogni Short, nell’ordine di ricerca di YouTube.

YouTube Shorts Search API

Input con parola chiave
Solo Shorts
Fino a 200 Shorts
0,6 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
queryObbligatorioLa parola chiave con cui cercare gli Shorts, fino a 100 caratteri.
results_limitFacoltativoQuanti 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.

  1. Invia con POST {"query": "meal prep", "results_limit": 25} a /v1/youtube/search-shorts.
  2. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

Combina i dati di YouTube con i dati pubblici delle altre piattaforme social supportate.

YouTube Shorts Search API — FAQ

YouTube Shorts Search API è un’interfaccia programmatica per cercare gli Shorts di YouTube per parola chiave. Restituisce link, didascalia, numero di visualizzazioni e miniatura verticale di ogni Short nell’ordine di ricerca di YouTube.

Invia l’URL dello Short a YouTube Videos, che restituisce canale, Mi piace, commenti e data di pubblicazione di ogni video.

Imposta results_limit da 1 a 200; il valore predefinito è 25, pari a circa una pagina di risultati Shorts.

La sua ricerca non ha un filtro solo per gli Shorts e videoDuration=short corrisponde a tutti i video sotto i quattro minuti. Questo endpoint prende i risultati dalla ricerca Shorts di YouTube, quindi ogni elemento restituito è uno Short.

Ogni Short restituito costa 0,6 crediti, quindi i 25 Shorts predefiniti costano 15 crediti.