youtube/
related-videos

Elenca i video che YouTube consiglia accanto a un video a partire dal suo URL, con titolo, canale, numero di visualizzazioni e miniatura di ogni video consigliato in un’unica esecuzione.

YouTube Related Videos API

Input con URL del video
Consigli sui prossimi video
Canale e visualizzazioni
0,5 crediti per risultato
Pronto
README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlObbligatorioIl 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.

  1. Invia con POST {"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"} a /v1/youtube/related-videos.
  2. Interroga GET /v1/tasks/{task_id} finché status diventa succeeded.
  3. 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.

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.

Esplora altre piattaforme

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

YouTube Related Videos API — FAQ

YouTube Related Videos API è un’interfaccia programmatica per elencare i video che YouTube consiglia accanto a un determinato video, a partire dall’URL di quel video. Restituisce titolo, canale, numero di visualizzazioni e miniatura di ogni video consigliato.

Restituisce l’intero elenco che YouTube mostra per quel video, di solito circa 20 video.

Sì. Sono accettati link agli Shorts, link youtu.be, link alle dirette e normali URL di visione.

Non più. La Data API ufficiale ha smesso di supportare il parametro di ricerca relatedToVideoId il 7 agosto 2023, quindi questo endpoint è il modo per leggere l’elenco che YouTube mostra accanto a un video.

Ogni video consigliato restituito costa 0,5 crediti, quindi un elenco tipico di 20 video costa 10 crediti.