YouTube Shorts
Gli Shorts di YouTube sono video in formato breve con titoli, contesto del canale, miniature, durata, dettagli di pubblicazione, classificazione di origine ed engagement visibile. Questi segnali sui contenuti e sulle prestazioni supportano la ricerca sui formati, il confronto tra creator, il monitoraggio delle tendenze e l’analisi delle campagne.
Funzionalità della YouTube Shorts API
- Raccolta di Shorts da più canaliRaccogli gli Shorts pubblici da più URL di canali in una sola richiesta.
- Limiti dei risultati per canaleImposta un results_limit separato per ogni canale in input, con 100 come valore predefinito.
- Metadati degli Short normalizzatiRestituisce identità dello Short normalizzata, metadati dei contenuti, miniature, durata, data di pubblicazione e canale che pubblica.
- Metriche di engagement riferite a un momento precisoInclude il numero pubblico di visualizzazioni, Mi piace e commenti con collected_at per confronti successivi.
- Ambito degli Shorts nativo della piattaformaUsa la classificazione degli Shorts di YouTube invece di definire i contenuti in formato breve solo in base alla durata o all’orientamento.
Parametri della YouTube Shorts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di canali YouTube pubblici, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero massimo di record idonei da richiedere per ogni URL in input. Deve essere un intero positivo e ha 100 come valore predefinito. |
Come usare la YouTube Shorts API
Crea un flusso pulito di contenuti in formato breve per un insieme noto di canali. L’attività separa la classificazione della piattaforma da eventuali regole di formato personalizzate che potresti applicare in seguito.
- Prepara gli URL dei canali pubblici; gli URL dei singoli Shorts vanno in Videos quando ti serve una ricerca diretta.
- Invia con POST urls e results_limit a /v1/youtube/shorts, tenendo conto del limite su ogni canale.
- Interroga /v1/tasks/{task_id} finché l’inventario dei canali termina.
- Indicizza i risultati per ID dello Short, conserva il contesto del canale e della raccolta, e scorri le pagine finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/shorts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/@NASA"],"results_limit":10}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casi d’uso della YouTube Shorts API
- Monitoraggio dell’attività in formato breve: Tieni traccia degli Shorts pubblici pubblicati da creator, brand, editori o concorrenti selezionati.
- Confronto delle prestazioni degli Shorts: Confronta frequenza di pubblicazione, durata, visualizzazioni, Mi piace e commenti tra i canali selezionati.
- Cataloghi di contenuti in formato breve: Costruisci una raccolta normalizzata di Shorts pubblici per la ricerca interna, la revisione o la reportistica.
- Analisi di argomenti e tendenze: Usa titoli, descrizioni, hashtag, dati dei canali e metriche pubbliche in flussi di lavoro di classificazione o ricerca.
Consigli degli esperti per la YouTube Shorts API
- Non riclassificare i risultati con una soglia di durata universale. La classificazione pubblica dei formati di YouTube è la specifica di questo endpoint.
- Il limite è per canale ed è un tetto, non una garanzia. Alcuni canali hanno pochi Shorts pubblici idonei o nessuno.
- Usa l’ID restituito per la deduplicazione; lo stesso elemento può comparire altrove nel tuo sistema attraverso forme diverse di URL pubblici.
- Conserva collected_at insieme alle metriche, perché i contatori visibili di uno Short possono cambiare rapidamente dopo la pubblicazione.
- Questo endpoint non cerca per parola chiave. Parti da Search per la scoperta degli argomenti, poi, se serve, indirizza gli URL di Shorts noti verso Videos.
- Raccogli Channel Videos separatamente quando ti serve un confronto pulito tra pubblicazioni in formato breve e regolari.
- Collega Channels tramite l’ID del canale per i campi del profilo e del pubblico, invece di ripetere su ogni elemento i metadati modificabili del canale.
API correlate
Oltre alla YouTube 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 Channel Live Videos API — Raccoglie i record pubblici delle trasmissioni presenti nelle sezioni live dei canali, con contesto della fonte e metriche visibili.
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts 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