YouTube Related Videos
I video correlati sono i consigli che YouTube allinea accanto a un video come prossime visioni, ciascuno mostrato con titolo, canale, numero di visualizzazioni e miniatura. Questo elenco rivela quali video e canali YouTube colloca nello stesso ambito, il che è utile per mappare una nicchia, trovare canali concorrenti e pianificare contenuti da affiancare a un video di riferimento.
Funzionalità della YouTube Related Videos API
- Qualsiasi link video comuneDagli URL di visione, dai link brevi youtu.be, dai link agli Shorts e dai link alle dirette viene letto l’ID del video.
- L’intero elenco in un’unica esecuzioneUn’attività restituisce l’elenco completo dei consigli che YouTube mostra per quel video, di solito circa 20 video.
- Chi ha creato ogni video consigliatoauthor contiene ID, nome e URL del canale dietro ogni video consigliato.
- Visualizzazioni e miniaturametrics.views_count viene ricavato dal conteggio mostrato da YouTube, per esempio 2.2M, e media fornisce la miniatura più grande.
Parametri della YouTube Related Videos API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Il link di un video YouTube: URL di visione, link youtu.be, link a uno Short o link a una diretta. |
Come usare la YouTube Related Videos API
Invia il link di un video e leggi i consigli.
- Invia con POST {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} a /v1/youtube/related-videos.
- Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
- Leggi i consigli da results.items e segui results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/related-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'
# Each item is one recommended video with author and metrics.views_count.Casi d’uso della YouTube Related Videos API
- Mappare una nicchia attorno a un video: Parti da un video forte e raccogli i suoi consigli, poi ripeti sui risultati per tracciare il gruppo di video che YouTube raggruppa insieme.
- Trovare i canali concorrenti: Conta quante volte ogni author.id compare accanto ai tuoi caricamenti per vedere quali canali YouTube continua a consigliare vicino a te.
- Verificare dove viene consigliato il tuo video: Esegui l’endpoint sui video popolari dei concorrenti e cerca gli ID dei tuoi video nei loro elenchi.
Consigli degli esperti per la YouTube Related Videos API
- Considera views_count un’approssimazione: deriva da testo arrotondato come 2.2M.
- I consigli cambiano nel tempo, quindi salva collected_at con ogni elenco quando confronti esecuzioni diverse.
- Invia gli URL dei video che conservi a YouTube Videos per ottenere conteggi esatti, date di pubblicazione e durate.
API correlate
Oltre alla YouTube Related 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 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 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