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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno 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_limit | Facoltativo | Numero 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à.
- 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.
- 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.
- Interroga /v1/tasks/{task_id} finché lo stato dell’attività è succeeded o failed.
- 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 trueCasi 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.
API correlate
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.
- YouTube Channels API
- YouTube Search API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Channel Search API
- YouTube Shorts Search API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API