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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL 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.
- Raccogli e deduplica gli URL pubblici di visione o di Shorts; gli URL di canali e di risultati di ricerca appartengono ad altri endpoint.
- Invia con POST l’array urls a /v1/youtube/videos e memorizza il task_id restituito accanto al tuo batch di origine.
- Interroga /v1/tasks/{task_id}; queued e running indicano che il batch è ancora in elaborazione.
- 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=50Casi 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.
API correlate
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.
- 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 Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API