youtube/
shorts

Raccogli gli Shorts pubblici dagli URL dei canali YouTube, con titoli normalizzati, contesto del canale, miniature, durata, dettagli di pubblicazione ed engagement visibile.

YouTube Shorts API

Shorts
Scoperta dei canali
Metriche pubbliche
0,5 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

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

ParametriObbligatorioDescrizione
urlsObbligatorioURL di canali YouTube pubblici, separati da virgole o da a capo.
results_limitFacoltativoNumero 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.

  1. Prepara gli URL dei canali pubblici; gli URL dei singoli Shorts vanno in Videos quando ti serve una ricerca diretta.
  2. Invia con POST urls e results_limit a /v1/youtube/shorts, tenendo conto del limite su ogni canale.
  3. Interroga /v1/tasks/{task_id} finché l’inventario dei canali termina.
  4. 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=50

Casi 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.

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.

Esplora altre piattaforme

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

YouTube Shorts API — FAQ

YouTube Shorts API raccoglie gli Shorts accessibili pubblicamente da uno o più URL di canali YouTube. Restituisce titoli normalizzati, informazioni sul canale, miniature, durata, date di pubblicazione, metriche di engagement e momento della raccolta.

Invia uno o più URL di canali YouTube pubblici e un results_limit facoltativo.

L’endpoint segue la classificazione degli Shorts di YouTube, senza usare soltanto una regola fissa di durata o di proporzioni.

results_limit ha 100 come valore predefinito e si applica separatamente a ogni URL di canale. Il numero finale può essere inferiore quando un canale ha meno Shorts pubblici idonei.

No. Visualizzazioni, Mi piace e commenti sono valori pubblici osservati nel momento della raccolta. Per un confronto storico servono raccolte ripetute.

L’utilizzo costa 0,5 crediti per ogni risultato di Short normalizzato restituito.