youtube/
videos

Recupera i metadati pubblici degli URL noti di video o Short di YouTube, con titoli normalizzati, contesto del canale, miniature, durata ed engagement visibile.

YouTube Videos API

Dettagli dei video
URL noti
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 Videos

I video di YouTube sono caricamenti pubblici con titoli, descrizioni, contesto del canale, miniature, durata, dettagli di pubblicazione, hashtag, classificazione di origine ed engagement visibile. Questi segnali sui metadati e sulle prestazioni supportano l’arricchimento dei video, la ricerca sui contenuti, il monitoraggio e l’analisi comparativa.

Funzionalità della YouTube Videos API

  • Ricerca in batch di URL notiCerca più URL noti di video e Short pubblici in una sola richiesta.
  • Identità stabile del videoRestituisce per ogni risultato un ID del video stabile, l’URL canonico, il titolo, la descrizione pubblica e il canale che pubblica.
  • Metadati dei contenutiInclude miniature, durata, hashtag, data di pubblicazione e tipo di contenuto normalizzato.
  • Metriche di engagement riferite a un momento precisoRileva il numero pubblico di visualizzazioni, Mi piace e commenti con collected_at per confronti riferiti a un momento preciso.
  • Schema video coerenteFornisce la stessa struttura video normalizzata per i video regolari e per gli URL di Short supportati.

Parametri della YouTube Videos API

ParametriObbligatorioDescrizione
urlsObbligatorioURL di video o Short di YouTube pubblici, separati da virgole o da a capo.

Come usare la YouTube Videos API

Trasforma una raccolta di link in record che la tua applicazione può collegare, cercare e aggiornare. La richiesta è asincrona, quindi conserva l’ID attività finché ogni URL accessibile non è stato risolto.

  1. Raccogli e deduplica gli URL pubblici di visione o di Shorts; gli URL di canali e di risultati di ricerca appartengono ad altri endpoint.
  2. Invia con POST l’array urls a /v1/youtube/videos e memorizza il task_id restituito accanto al tuo batch di origine.
  3. Interroga /v1/tasks/{task_id}; queued e running indicano che il batch è ancora in elaborazione.
  4. Dopo il successo, indicizza data.results.items per id e continua con next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=arj7oStGLkU"]}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Casi d’uso della YouTube Videos API

  • Arricchimento di elenchi di URL: Aggiungi titoli, informazioni sul canale, miniature, durata, date di pubblicazione e metriche pubbliche a un elenco esistente di URL di YouTube.
  • Confronto di video selezionati: Confronta visualizzazioni, Mi piace, commenti, durata e informazioni di pubblicazione pubblici su un insieme scelto di video o Shorts.
  • Monitoraggio di campagne e concorrenti: Raccogli istantanee ripetute dei metadati per video noti di campagne, creator o concorrenti.
  • Cataloghi di contenuti: Fornisci record di video normalizzati a flussi di lavoro interni di ricerca, reportistica, moderazione, riassunto o analisi.

Consigli degli esperti per la YouTube Videos API

  • Usa id come chiave primaria. I titoli possono cambiare e lo stesso video può arrivare attraverso diversi formati di URL validi.
  • Mantieni canonical_url per i link in uscita, ma conserva input_url quando ti serve risalire all’origine di un record.
  • Le metriche descrivono la pagina al momento di collected_at. Confrontare due istantanee è utile; sovrascrivere la precedente elimina quello storico.
  • Tratta i link delle descrizioni come input esterno non attendibile prima di visualizzarli, scansionarli o importarli.
  • Un risultato mancante non prova che un URL non sia mai esistito. Elementi privati, eliminati, limitati o temporaneamente inaccessibili possono sparire da un batch.
  • Commenti e testo delle trascrizioni sono volutamente separati. Richiedili solo per gli elementi che arrivano a quelle fasi nel tuo flusso di lavoro.
  • Per la scoperta per argomento, parti da Search. Usa Videos quando sai già quale URL conta.

Oltre alla YouTube Videos 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 Shorts API — Raccoglie Shorts pubblici, miniature, durata, dettagli di pubblicazione ed engagement per canale.
  • YouTube Related Videos API — Elenca i video consigliati accanto all’URL di un video, con titoli, canali, visualizzazioni e miniature.

Esplora altre piattaforme

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

YouTube Videos API — FAQ

YouTube Videos API recupera i metadati pubblici degli URL noti di video o Short di YouTube. Restituisce identità normalizzata, titoli, descrizioni, informazioni sul canale, miniature, durata, date di pubblicazione, metriche di engagement e momento della raccolta.

Invia uno o più URL di video o Short di YouTube pubblici nell’array urls.

Sì. Gli URL di Short pubblici sono supportati e usano la stessa struttura video normalizzata, con il tipo di contenuto conservato.

No. Le metriche sono valori pubblici osservati nel momento della raccolta. Salva collected_at e raccogli di nuovo gli stessi URL quando servono confronti storici.

Il risultato del video include il numero pubblico di commenti, non il testo dei commenti né quello delle trascrizioni. Usa Comments per i record dei commenti e Transcripts per i sottotitoli disponibili.

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