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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
results_limit | Facoltativo | Quanti 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à.
- Invia con POST {"results_limit": 48} a /v1/youtube/trending-shorts; il corpo può anche essere vuoto.
- 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/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.
API correlate
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.
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API