youtube/
trending-shorts

Ottieni un campione degli Shorts di tendenza su YouTube in questo momento senza alcun input, con titoli, canali, visualizzazioni, Mi piace, commenti, durata e orari esatti di pubblicazione.

YouTube Trending Shorts API

Nessun input richiesto
Nuovo campione a ogni esecuzione
Visualizzazioni, Mi piace, commenti
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

YouTube Trending Shorts

Gli Shorts di tendenza sono i video verticali che YouTube sta spingendo verso un pubblico ampio in questo momento, ciascuno con titolo, canale che lo ha pubblicato, numero di visualizzazioni, Mi piace e commenti, durata e orario esatto di pubblicazione. Letti insieme, questi segnali mostrano quali argomenti, formati e creator stanno emergendo e quanto rapidamente uno Short accumula visualizzazioni dopo la pubblicazione.

Funzionalità della YouTube Trending Shorts API

  • Direttamente dalle tendenze del momentoNon c’è nulla da compilare: ogni esecuzione preleva gli Shorts che YouTube sta promuovendo in quel momento, circa 48 per prelievo, e i prelievi ripetuti vengono uniti senza duplicati fino a results_limit.
  • Tre conteggi di engagement per Shortmetrics riporta il numero esatto di visualizzazioni e Mi piace insieme al numero di commenti mostrato da YouTube, così uno Short molto discusso si distingue da uno che viene soltanto guardato.
  • Canale associato a ogni Shortauthor contiene ID, handle, nome, URL e avatar del canale, pronti da passare alle API a livello di canale.
  • Orario di pubblicazione e duratapublished_at è l’orario preciso di caricamento in UTC e duration_seconds la durata, che insieme indicano quanto è recente e quanto è lungo uno Short di tendenza.
  • Hashtag estratti dalla didascaliaI tag scritti nel titolo o nella descrizione sono elencati in hashtags, senza il # iniziale.

Parametri della YouTube Trending Shorts API

ParametriObbligatorioDescrizione
results_limitFacoltativoQuanti Shorts di tendenza restituire, da 1 a 200. Il valore predefinito è 48.

Come usare la YouTube Trending Shorts API

Invia un numero di risultati facoltativo, poi leggi gli Shorts al termine dell’attività.

  1. Invia con POST {"results_limit": 48} a /v1/youtube/trending-shorts; il corpo può anche essere vuoto.
  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/trending-shorts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"results_limit":48}'

# Each item is one Short with metrics.views_count and author.
# Read them from GET /v1/tasks/{task_id}.

Casi d’uso della YouTube Trending Shorts API

  • Istantanee quotidiane delle tendenze: Esegui l’endpoint a orari prestabiliti e salva ogni lotto per vedere quali argomenti e formati continuano a comparire tra gli Shorts di tendenza.
  • Individuare i creator emergenti: Confronta views_count con published_at per trovare i canali i cui caricamenti recenti raccolgono milioni di visualizzazioni in pochi giorni.
  • Monitoraggio degli hashtag negli Shorts: Conta gli hashtag presenti negli Shorts di tendenza per vedere quali tag accompagnano i video brevi virali di questa settimana.

Consigli degli esperti per la YouTube Trending Shorts API

  • Ogni esecuzione è un nuovo campione, quindi conserva l’id di ogni Short che salvi e salta i duplicati quando unisci esecuzioni a pochi minuti di distanza.
  • Dividi views_count per le ore trascorse da published_at per ordinare gli Shorts in base alla velocità anziché alle visualizzazioni totali.
  • Invia author.url a YouTube Channels quando ti servono anche il numero di iscritti e le descrizioni dei canali.

Oltre alla YouTube Trending Shorts 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 Transcripts API — Recupera le trascrizioni disponibili in testo semplice con scelta facoltativa della lingua.
  • YouTube Channels API — Recupera identità del canale pubblico, immagini, verifica e statistiche visibili del pubblico.
  • YouTube Videos API — Recupera metadati, miniature, durata ed engagement a partire dagli URL di video o Short noti.
  • YouTube Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.

Esplora altre piattaforme

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

YouTube Trending Shorts API — FAQ

YouTube Trending Shorts API è un’interfaccia programmatica per ottenere un campione degli Shorts che YouTube sta promuovendo come tendenze, senza alcun input di ricerca. Restituisce per ogni Short titolo, canale, numero di visualizzazioni, Mi piace e commenti, durata e orario di pubblicazione.

Ogni esecuzione preleva un nuovo campione dalle tendenze del momento, quindi esecuzioni a pochi minuti di distanza hanno in comune solo pochi Shorts. Pianificare più esecuzioni e unirle per id offre una visione più ampia di ciò che è di tendenza.

Imposta results_limit da 1 a 200; il valore predefinito è 48, pari a circa un prelievo dalle tendenze.

Visualizzazioni e Mi piace sì: views_count e likes_count sono interi completi presi da ogni Short. comments_count segue il valore mostrato da YouTube, quindi i conteggi oltre il migliaio sono arrotondati, per esempio 4800 per 4.8K, e Mi piace o commenti sono null quando un creator li nasconde.

Non esiste un parametro per il paese. Ogni esecuzione restituisce gli Shorts presenti tra le tendenze in quel momento, quindi pianifica le esecuzioni e uniscile per id per seguire come cambiano le tendenze.

Ogni Short restituito costa 0,5 crediti, quindi i 48 Shorts predefiniti costano 24 crediti.