youtube/
comments

Raccogli i commenti di YouTube visibili pubblicamente da uno o più URL di video, con testo normalizzato, autori, Mi piace, numero di risposte, video di origine e contesto della conversazione.

YouTube Comments API

Commenti
Dati delle discussioni
URL dei video
0,3 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 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

ParametriObbligatorioDescrizione
urlsObbligatorioURL di video YouTube pubblici con commenti visibili, separati da virgole o da a capo.
results_limitFacoltativoNumero massimo di record idonei da richiedere per ogni URL in input. Deve essere un intero positivo e ha 100 come valore predefinito.
sort_byFacoltativoOrdinamento 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.

  1. Scegli gli URL dei video pubblici e definisci se ti servono le reazioni attuali o la discussione ordinata da YouTube.
  2. Invia con POST urls, results_limit e sort_by a /v1/youtube/comments; il limite si applica a ogni video.
  3. Interroga /v1/tasks/{task_id}, lasciando che nello stesso batch si risolvano i video con commenti attivi e le sezioni commenti non disponibili.
  4. 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=50

Casi 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.

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.

Esplora altre piattaforme

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

YouTube Comments API — FAQ

YouTube Comments API raccoglie i commenti visibili pubblicamente da uno o più URL di video YouTube. Restituisce testo normalizzato, dettagli dell’autore, ora di pubblicazione, Mi piace, numero di risposte, riferimenti al video di origine, ID dei commenti principali e momento della raccolta.

Invia uno o più URL di video YouTube pubblici, un results_limit facoltativo e un valore sort_by facoltativo.

Usa newest per avere prima i commenti più recenti o relevance per l’ordine di rilevanza pubblico di YouTube. newest è il valore predefinito.

I record delle risposte possono includere parent_comment_id, mentre replies_count mostra il numero pubblico di risposte associate a un commento.

results_limit è un massimo per video. I video con commenti disattivati, filtrati, limitati o con meno commenti visibili pubblicamente possono restituire meno record o un risultato vuoto.

L’utilizzo costa 0,3 crediti per ogni risultato di commento normalizzato restituito.