youtube/
comment-replies

Raccogli le risposte pubbliche di YouTube a partire da un URL di video stabile e dall’ID del commento principale, con testo, autori, engagement, timestamp e contesto del thread.

YouTube Comment Replies API

Input stabile del commento
Risposte pubbliche
Contesto del thread
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 Comment Replies

Le risposte ai commenti di YouTube sono risposte pubbliche annidate sotto un commento di primo livello di un video, con testo della risposta, identità dell’autore, Mi piace visibili, ora di pubblicazione e contesto del commento principale o del video. Questi record dei thread supportano la ricostruzione delle conversazioni, la revisione delle risposte e la preparazione di dataset di discussioni pubbliche.

Funzionalità della YouTube Comment Replies API

  • Riferimento stabile al commentoParti dall’URL di un video pubblico e dall’ID del suo commento principale, mentre SocQ risolve internamente l’attuale token di continuazione delle risposte.
  • Record di risposte e autoriRestituisce ID delle risposte, testo pubblico, URL associati, orari di pubblicazione e identità normalizzata dell’autore o del canale.
  • Contesto del thread e del creatorConserva insieme Mi piace visibili, numero di risposte annidate, riferimenti al commento principale e al video, e indicatori del proprietario del canale o del cuore del creator.
  • Raccolta di continuazione con limitiSegue i successivi token di continuazione della fonte, rimuove gli ID di risposta duplicati e si ferma al limite scelto, a un thread esaurito o al tetto di 100 pagine.

Parametri della YouTube Comment Replies API

ParametriObbligatorioDescrizione
urlObbligatorioURL obbligatorio e stabile di un video YouTube pubblico che contiene il commento principale.
comment_idObbligatorioID obbligatorio del commento di primo livello appartenente all’URL del video inviato.
results_limitFacoltativoNumero massimo di risposte pubbliche da raccogliere da questo thread. L’esempio documentato usa 20 e l’intervallo accettato va da 20 a 2000.

Come usare la YouTube Comment Replies API

Invia l’URL di un video stabile e l’ID del commento principale come attività asincrona, poi leggi i record normalizzati delle risposte dall’attività completata.

  1. Scegli l’URL di un video YouTube pubblico e l’ID di un commento di primo livello restituito per quel video.
  2. Invia con POST url, comment_id e results_limit a /v1/youtube/comment-replies.
  3. Conserva il task_id restituito e interroga GET /v1/tasks/{task_id} finché l’attività è in stato queued, running o retrying.
  4. Dopo il successo leggi data.results.items e passa data.results.next_cursor come cursor nella richiesta dell’attività finché data.results.has_more è true.
curl -X POST "https://api.socq.ai/v1/youtube/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","comment_id":"Ugzge340dBgB75hWBm54AaABAg","results_limit":20}'

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

Casi d’uso della YouTube Comment Replies API

  • Ricostruzione di un thread noto: Usa gli ID delle risposte, parent_comment_id, video_id, gli URL e i timestamp per ricollegare le risposte salvate a un commento di primo livello selezionato.
  • Revisione del pubblico a livello di risposta: Confronta testo delle risposte pubbliche, identità degli autori, Mi piace visibili, numero di risposte annidate e indicatori di interazione del creator all’interno di un thread noto.
  • Preparazione di dataset di discussioni pubbliche: Combina testo normalizzato delle risposte, autori, timestamp e contesto del thread in record per la revisione manuale o per l’elaborazione successiva del testo.

Consigli degli esperti per la YouTube Comment Replies API

  • Tieni abbinati l’URL del video e l’ID del commento di primo livello, così il thread delle risposte e il video di origine restano allineati.
  • SocQ risolve internamente l’attuale token di continuazione; se un token a monte scade, riprova con lo stesso riferimento stabile.
  • Tieni separato l’ID del commento di origine dal cursore restituito da GET /v1/tasks/{task_id}: il primo seleziona un thread di risposte di YouTube, il secondo scorre i risultati salvati dell’attività.
  • Imposta results_limit sulla dimensione attesa del thread, ma consideralo un tetto, perché la visibilità pubblica e l’esaurimento del thread possono ridurre il numero restituito.
  • Deduplica i record salvati per ID della risposta e conserva parent_comment_id, video_id ed extra.reply_token quando ricolleghi le risposte al commento di origine.
  • Ammetti campi nulli per autore, timestamp, metriche e indicatori del creator, e fai l’escape del testo pubblico delle risposte prima di mostrarlo in un’altra interfaccia.

Oltre alla YouTube Comment Replies 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 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 Comment Replies API — FAQ

YouTube Comment Replies API è un’interfaccia programmatica per raccogliere le risposte pubbliche a un singolo commento di primo livello di YouTube. Invia l’URL stabile del video e l’ID del commento per ricevere testo delle risposte, identità degli autori, engagement visibile, timestamp e contesto del thread.

Esegui YouTube Comments API con l’URL di un video pubblico, poi usa l’ID di un commento di primo livello compatibile restituito per quello stesso video.

No. SocQ risolve l’attuale token di continuazione a partire dall’URL del video e dall’ID del commento inviati; l’input del token legacy resta un percorso di compatibilità dell’API, ma questo playground non lo usa.

results_limit accetta interi da 20 a 2000 e l’esempio documentato del playground invia 20. La raccolta si ferma a quel tetto, quando il thread pubblico termina o dopo 100 pagine della fonte.

Una risposta può includere ID, URL, testo, dettagli pubblici dell’autore o del canale, Mi piace visibili e numero di risposte annidate, orari di pubblicazione e di raccolta, oltre al contesto di video, commento principale, indicatore del creator e token in extra.

No. comment_id seleziona il thread di risposte di YouTube di origine, mentre cursor scorre i record normalizzati già salvati in un’attività SocQ completata con successo.

Il commento principale potrebbe non esporre un token delle risposte, il thread può terminare prima di results_limit, oppure le risposte possono essere eliminate, nascoste, in attesa di revisione, riservate ai membri, disattivate o comunque non disponibili al pubblico.

Ogni risposta normalizzata salvata costa 0,5 crediti. La fatturazione segue il numero effettivo di record salvati, quindi un risultato vuoto non ha alcun addebito per unità di risultato.