youtube/
playlist-videos

Raccogli video normalizzati da URL o ID di playlist YouTube pubbliche, con titoli, contesto del canale, miniature, durata e provenienza della playlist per ogni record.

YouTube Playlist Videos API

Inventari delle playlist
URL o ID semplice
Provenienza della playlist
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 Playlist Videos

I video di una playlist YouTube sono le voci raggruppate in una playlist pubblica, con identità del video, titoli, contesto del canale, miniature, durata e provenienza della playlist. Questi record supportano la catalogazione delle playlist, l’indicizzazione di serie, la revisione dei contenuti e l’arricchimento dei link ai video.

Funzionalità della YouTube Playlist Videos API

  • Input di più playlist tramite URL e IDElabora in un’attività uno o più URL di playlist pubbliche o ID semplici di playlist, con results_limit applicato separatamente a ogni playlist risolta.
  • Righe normalizzate del catalogo videoRestituisce ID dei video, titoli, URL canonici, identità del canale, una miniatura, durata in secondi e momento della raccolta in una struttura coerente.
  • Provenienza della playlist e del proprietarioConserva ID della playlist, titolo della playlist, testo leggibile della durata e contesto del proprietario della playlist quando una riga di video non espone i propri campi del canale.

Parametri della YouTube Playlist Videos API

ParametriObbligatorioDescrizione
urlsObbligatorioUno o più URL di playlist pubbliche che contengono un valore della query list oppure ID semplici di playlist, separati da virgole o da a capo.
results_limitFacoltativoNumero massimo di record da conservare dall’array di video restituito per ogni playlist; il valore predefinito è 100 e sono accettati interi da 10 a 2.000.

Come usare la YouTube Playlist Videos API

Invia riferimenti noti a playlist pubbliche come attività asincrona, poi scorri le righe di video normalizzate salvate dopo il successo dell’attività.

  1. Prepara uno o più URL di playlist pubbliche che contengono un valore della query list oppure ID semplici di playlist, e rimuovi i riferimenti duplicati.
  2. Invia con POST urls e un results_limit facoltativo da 10 a 2.000 a /v1/youtube/playlist-videos, poi salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché lo stato dell’attività è succeeded o failed.
  4. Leggi data.results.items e continua con results.next_cursor finché results.has_more è true; riconcilia gli ID delle playlist e dei video con il tuo insieme di origine.
curl -X POST "https://api.socq.ai/v1/youtube/playlist-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/playlist?list=PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casi d’uso della YouTube Playlist Videos API

  • Inventari delle playlist pubbliche: Costruisci un inventario strutturato di ID dei video, titoli, URL, identità del canale, miniature, durata e provenienza della playlist per playlist pubbliche selezionate.
  • Indicizzazione di corsi e serie: Indicizza i titoli delle playlist con i titoli dei loro video, il contesto del canale, le durate e i link di origine per organizzare corsi, interventi o raccolte episodiche pubblici.
  • Elenchi di partenza per l’arricchimento dei video: Usa gli URL canonici e gli ID dei video restituiti come coda deduplicata per flussi di lavoro separati di dettaglio, trascrizione, revisione o archiviazione.

Consigli degli esperti per la YouTube Playlist Videos API

  • Usa un ID semplice di playlist oppure un URL il cui valore della query list sia valorizzato; le altre parti dell’URL non servono a risolvere la playlist e un URL senza list viene ignorato.
  • Considera results_limit come un tetto per playlist sul primo array di video restituito, non come la garanzia di un’estrazione profonda per una playlist di grandi dimensioni.
  • Riporta ogni playlist a un’unica rappresentazione prima di creare i batch, perché vengono rimosse solo le stringhe esattamente duplicate e le varianti di URL della stessa playlist possono causare lavoro ripetuto.
  • Confronta i valori restituiti di extra.playlist_id e id del video con il tuo insieme di input, perché le voci private, eliminate, limitate, nascoste, malformate o non disponibili possono mancare.
  • Usa collected_at per la tracciabilità dei record e richiedi separatamente i dettagli dei video quando servono date di pubblicazione o engagement, perché metrics è vuoto e created_at è null.

Oltre alla YouTube Playlist 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 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 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 Playlist Videos API — FAQ

YouTube Playlist Videos API è un’interfaccia programmatica per raccogliere righe di video normalizzate da URL di playlist YouTube pubbliche o da ID semplici di playlist. Restituisce identità del video, titoli, URL canonici, contesto del canale, miniature, durata, provenienza della playlist e momento della raccolta.

Invia un array urls non vuoto contenente URL di playlist con un valore della query list oppure ID semplici di playlist. results_limit è facoltativo, ha 100 come valore predefinito, accetta da 10 a 2.000 e si applica separatamente a ogni playlist.

Ogni record può includere ID del video, titolo, URL canonico, ID, handle, nome e URL del canale, una miniatura, durata in secondi, momento della raccolta, ID della playlist, titolo della playlist e testo leggibile della durata. L’oggetto metrics normalizzato è vuoto e created_at è null.

No. Posizione nella playlist, numero totale di video, riproducibilità e stato delle voci non disponibili non vengono conservati, e le voci mancanti non sono rappresentate da record segnaposto.

No. Il limite fissa un tetto ai video conservati da un array di video restituito per playlist; l’attuale collector non richiede le pagine di continuazione della fonte.

Una playlist può produrre meno record quando è privata, non disponibile, malformata, non risolvibile, limitata o contiene voci nascoste e inaccessibili. Un URL senza un valore non vuoto della query list viene ignorato.

L’utilizzo costa 0,5 crediti per ogni record di video normalizzato restituito, senza costo base. I risultati vuoti non comportano alcun addebito per risultato secondo l’attuale policy sui risultati vuoti.