YouTube Comments
I commenti di YouTube sono le risposte pubbliche del pubblico ai video, con testo, contesto dell’autore, ora di pubblicazione, Mi piace visibili, numero di risposte, dettagli del video di origine e relazioni della conversazione. Questi segnali delle discussioni supportano l’analisi dei feedback, la ricerca sul pubblico, la revisione degli argomenti e il monitoraggio delle reazioni.
Funzionalità della YouTube Comments API
- Raccolta di commenti da più videoRaccogli i commenti pubblici da più URL di video in una sola richiesta.
- Limiti e ordinamento per videoImposta un results_limit per ogni video e scegli l’ordinamento per più recenti o per rilevanza.
- Campi di commenti e autoriRestituisce ID del commento, testo, dettagli pubblici dell’autore, ora di pubblicazione e informazioni sul video di origine.
- Relazioni dei threadInclude il numero pubblico di Mi piace, il numero di risposte e l’ID del commento principale per un’analisi strutturata delle discussioni.
- Indicatori di interazione del creatorConserva gli indicatori del proprietario del canale e del cuore del creator quando sono presenti nel risultato pubblico.
Parametri della YouTube Comments API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | URL di video YouTube pubblici con commenti visibili, separati da virgole o da a capo. |
results_limit | Facoltativo | Numero massimo di record idonei da richiedere per ogni URL in input. Deve essere un intero positivo e ha 100 come valore predefinito. |
sort_by | Facoltativo | Ordinamento dei commenti. Il valore predefinito è newest; relevance usa la classifica pubblica di YouTube. |
Come usare la YouTube Comments API
Decidi se conta di più la freschezza o la rilevanza, imposta un budget di campionamento per video e mantieni intatte le relazioni restituite quando i commenti entrano nella tua pipeline di analisi.
- Scegli gli URL dei video pubblici e definisci se ti servono le reazioni attuali o la discussione ordinata da YouTube.
- Invia con POST urls, results_limit e sort_by a /v1/youtube/comments; il limite si applica a ogni video.
- Interroga /v1/tasks/{task_id}, lasciando che nello stesso batch si risolvano i video con commenti attivi e le sezioni commenti non disponibili.
- Dopo il successo, deduplica per ID del commento, collega le risposte con parent_comment_id e scorri le pagine finché has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],"results_limit":10,"sort_by":"newest"}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50Casi d’uso della YouTube Comments API
- Analisi dei feedback del pubblico: Analizza il testo dei commenti pubblici per individuare sentiment, domande ricorrenti, temi e idee per i contenuti.
- Monitoraggio di campagne ed eventi: Tieni traccia delle reazioni pubbliche a creator, lanci di prodotto, campagne, annunci o eventi.
- Ricerca sulle discussioni: Usa Mi piace, numero di risposte e riferimenti al commento principale per studiare i commenti con più engagement e i thread attivi.
- Dataset per l’analisi del testo: Fornisci commenti normalizzati a flussi di lavoro di classificazione, clustering, riassunto, assistenza alla moderazione o allerta.
Consigli degli esperti per la YouTube Comments API
- Scegli sort_by prima dell’analisi. Passare da relevance a newest cambia il campione, quindi le due esportazioni non vanno confrontate come se differissero solo per l’ordine.
- Considera results_limit come un tetto per video. Commenti disattivati, moderazione, classifica, restrizioni e scarsa attività possono ridurre il numero restituito.
- Usa l’ID del commento per la deduplicazione e parent_comment_id per il collegamento, ma non dare per scontato che ogni risposta visibile sia presente nella stessa pagina di risultati.
- I totali di Mi piace e risposte sono osservazioni del momento della raccolta, non misure fisse di sentiment o importanza.
- Il testo dei commenti e i campi degli autori sono input pubblici non attendibili. Fai l’escape nelle interfacce e convalida gli eventuali URL incorporati prima dell’uso.
- Una corrispondenza di parole chiave non è un’analisi del sentiment. Conserva il testo originale e il contesto di origine quando applichi etichette o riassunti.
- Mantieni l’ID del video e collected_at su ogni riga, così chi analizza può riprodurre quale campione di conversazione ha esaminato.
API correlate
Oltre alla YouTube Comments 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 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 Comment Replies API — Prosegue un thread di commenti YouTube noto a partire dal token delle risposte e restituisce risposte pubbliche, autori, engagement e contesto del commento principale.
- YouTube Community Post Comments API — Raccoglie i commenti dal link di un post della community, con i canali di chi commenta, numero di Mi piace e numero di risposte.
- YouTube Shorts API
- YouTube Search API
- YouTube Channel Live Videos API
- YouTube Community Posts API
- YouTube Hashtag Search API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post 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