Como encontrar comentários do YouTube sobre um momento específico do vídeo

1. Defina o momento do vídeo e os limites da coleta

Escolha um vídeo público conhecido. Registre seu ID, sua URL pública e sua duração. Um ID é um código que identifica um registro da fonte. A duração é o tempo total de reprodução do vídeo.

Anote o momento que deseja estudar antes de selecionar os comentários. Você pode usar um tempo exato ou um tempo inicial e um final. Informe se o limite final faz parte do intervalo de busca. Isso evita que escolhas posteriores alterem a pergunta.

Uma correspondência no índice significa que um comentário contém uma referência verificada dentro desse intervalo. Isso não significa que você encontrou todas as discussões sobre a cena. Alguns comentários descrevem uma cena sem escrever seu tempo.

Em seguida, declare os limites da coleta:

Um comentário principal é um comentário que não é uma resposta. Um limite define o número máximo solicitado. Esse limite não garante que a fonte retornará essa quantidade de registros.

Mais relevantes segue a ordem de destaque da fonte. Mais recentes segue a ordem de recência. Ambos usa as duas listas e remove IDs de comentários repetidos na mesma execução. Essas escolhas definem uma amostra limitada. Para ajudar na escolha da ordem, consulte o guia de amostragem de comentários.

2. Colete um pequeno conjunto com respostas

Um Actor é um programa hospedado que coleta dados. O contrato do YouTube Comments Scraper, verificado em 25 de outubro de 2026; apenas documentação documenta a coleta de comentários públicos a partir de URLs ou IDs conhecidos de vídeos. Ele também documenta a coleta opcional de respostas com um limite.

O Actor fornece registros de comentários. Você precisa extrair as referências de tempo, verificar o vídeo e criar o índice.

Use esta pequena entrada como ponto de partida:

{
  "startUrls": ["https://www.youtube.com/watch?v=dQw4w9WgXcQ"],
  "maxCommentsPerVideo": 20,
  "commentSortMode": "newest",
  "includeReplies": true,
  "maxRepliesPerComment": 5
}

Substitua toda a lista `startUrls` pelo vídeo público desejado. A URL da música fornecida é um exemplo do esquema de entrada. Ela não comprova um resultado de comentários útil para este método.

Essa entrada solicita até 20 comentários principais únicos na ordem Mais recentes. Ela também solicita até 5 respostas para cada comentário principal coletado. As respostas ocupam linhas adicionais. Elas não entram no limite de comentários principais. Os números descrevem os limites solicitados, não as quantidades retornadas nem o número de pessoas.

A entrada documentada aceita de 1 a 100 entradas de vídeo. `maxCommentsPerVideo` aceita números inteiros de 1 a 1.000. Quando a coleta de respostas está ativada, `maxRepliesPerComment` aceita números inteiros de 1 a 100.

Uma Task é uma configuração de entrada salva. A Task pública de exportação de comentários e respostas, verificada em 25 de outubro de 2026; apenas presença da página é um ponto de partida para essa coleta. Substitua a lista de vídeos de exemplo e verifique as configurações antes do uso.

A entrada fornecida passou por uma verificação com base nas regras de entrada documentadas. A página pública da Task e seu ID foram encontrados. Nenhuma entrada salva ou execução paga foi verificada. Essas verificações não comprovam o sucesso da coleta nem a cobertura completa das respostas.

3. Salve os comentários separados das referências de tempo

Mantenha duas tabelas. Uma tabela de comentários armazena os registros originais da discussão. Uma tabela de relações armazena as ligações entre comentários e tempos do vídeo. Uma relação é uma conexão registrada entre duas coisas.

Mantenha uma linha de comentário por ID estável de comentário. Use o ID do vídeo junto com o ID do comentário quando combinar vídeos. Não una comentários porque seus textos são iguais.

Salve estes campos da fonte quando estiverem presentes:

O recurso de comentários do YouTube, verificado em 25 de outubro de 2026; apenas conceitos de identificação e tempo distingue o ID de um comentário do ID do comentário ao qual uma resposta se liga. Seu registro de data e hora de publicação informa quando um comentário foi publicado. Ele não indica uma posição no vídeo. O Actor tem seus próprios campos documentados.

Mantenha os valores ausentes como ausentes. Um valor nulo em `publishedAt` significa que a data exata não está disponível. Não significa zero. Não o substitua por `scrapedAt` nem o converta em um tempo do vídeo.

Preserve os vínculos com os comentários aos quais as respostas se ligam, mesmo quando esses comentários estiverem ausentes da exportação. Registre essa falta de contexto. Não associe uma resposta a outro comentário porque o texto parece semelhante.

4. Extraia cada tempo escrito como uma referência candidata

Uma marcação de tempo é um pequeno trecho de texto que pode indicar uma posição no vídeo. Alguns exemplos são 37:07 e 1:02:03. Uma referência candidata é uma possível referência que você ainda não confirmou.

Leia o texto original e crie uma linha de relação para cada ocorrência de uma referência candidata. Mantenha a marcação original e sua posição no texto. Conte as posições a partir de zero: o primeiro caractere ocupa a posição 0.

Não altere os espaços nem a pontuação antes de registrar as posições. Outro leitor deve conseguir encontrar a mesma marcação no texto salvo. Se usar outra regra de contagem, informe qual é e mantenha seu uso consistente.

Sua tabela de relações precisa destes campos. São campos que você cria para o índice, não uma saída prometida pelo Actor:

Um comentário pode conter vários tempos. Um mesmo tempo também pode aparecer duas vezes em um comentário. Mantenha essas ocorrências separadas durante a extração. Nenhum desses casos cria outro comentário ou outra pessoa.

Uma resposta pode discutir o tempo indicado no comentário ao qual responde sem escrever um tempo próprio. Mantenha essa resposta como contexto. Não invente uma marcação nem uma referência à cena verificada para ela.

5. Valide a marcação antes da conversão

Verifique a marcação inteira antes de calcular os segundos. Não transforme uma marcação negativa ou malformada em um tempo válido ao extrair apenas uma parte dela.

Use estas regras:

1. Aceite o formato de minutos e segundos ou o formato de horas, minutos e segundos.
2. Mantenha os segundos abaixo de 60.
3. No formato com horas, mantenha o grupo intermediário de minutos abaixo de 60.
4. Rejeite valores negativos e grupos inválidos.
5. Converta as marcações válidas em segundos.
6. Compare o resultado com a duração conhecida do vídeo.

Para minutos e segundos, multiplique os minutos por 60 e depois some os segundos:

37:07 = 37 × 60 segundos + 7 segundos = 2.227 segundos.

Para horas, minutos e segundos, multiplique as horas por 3.600, multiplique os minutos por 60 e some os segundos:

1:02:03 = 1 × 3.600 segundos + 2 × 60 segundos + 3 segundos = 3.723 segundos.

No formato de dois grupos, os minutos são o primeiro grupo. Eles podem passar de 59. No formato de três grupos, as horas são o primeiro grupo. Os grupos seguintes de minutos e segundos devem ficar abaixo de 60.

Assim, 37:67 não passa na validação. Não corrija a marcação sem registrar a alteração. Mantenha a marcação original e o motivo da falha.

Uma marcação além da duração conhecida deve aguardar análise. Não a mova para o tempo válido mais próximo. Se a duração for desconhecida, deixe sua verificação pendente. Um tempo exatamente no fim também exige uma verificação por reprodução antes de ser considerado uma referência à cena.

Zero é diferente de um valor ausente. A marcação 0:00 indica o início do vídeo. Um campo vazio de tempo convertido significa que nenhuma conversão aceita está disponível.

6. Assista ao momento e leia a discussão

Um número válido ainda é apenas uma referência candidata. Ele pode descrever outra coisa. Assista ao momento indicado antes de classificá-lo.

Para cada referência candidata que passar nas verificações:

1. Abra o vídeo correspondente e avance até o tempo convertido.
2. Assista e ouça o trecho ao redor desse ponto.
3. Leia o comentário original.
4. Leia o comentário ao qual ele responde e as respostas disponíveis.
5. Escreva uma nota curta sobre o que conseguiu confirmar.
6. Atribua um estado de revisão.

Use estes estados de forma consistente:

Mantenha os resultados da validação separados desses estados de revisão. Uma marcação inválida falha na verificação de formato. Uma referência pendente não tem um fato necessário confirmado. Uma referência verificada fora do intervalo de interesse pode permanecer no índice mais amplo sem entrar nos resultados da busca.

Escreva anotações que descrevam a ligação. Não deduza a intenção de um espectador nem uma opinião compartilhada pelo público. Um limite de respostas também significa que pode faltar contexto relevante. Declare esse limite.

Se precisar decidir se falta uma explicação em um tutorial, prossiga com a verificação de lacunas na aula. Uma referência à cena, por si só, não comprova uma lacuna na aula. Se precisar de uma explicação que nenhum comentário menciona, use o método separado de navegação por conceitos.

7. Siga um exemplo fictício original

Tudo neste exemplo é ficção original. O vídeo, os comentários, a resposta e as notas de visualização foram inventados para ensinar o método. Eles não são uma saída do Actor. Não houve execução real de coleta de comentários nem verificação por reprodução.

O vídeo fictício dura 40:00:

40 × 60 segundos = 2.400 segundos.

O comentário C contém exatamente este texto:

“37:07 explica a montagem; 38:10 mostra o resultado.”

As aspas servem para apresentar o exemplo. Elas não fazem parte do texto salvo do comentário. O primeiro caractere de 37:07 ocupa a posição 0.

Preserve um comentário e duas referências

A tabela de comentários contém C uma única vez. A resposta R ocupa uma linha separada, vinculada a C. Nesta ficção, R diz: “Essa comparação ajudou.” Ela não contém uma marcação de tempo.

As duas marcações em C geram duas linhas de relação:

A segunda marcação começa na posição 26. A posição 25 é o espaço depois do ponto e vírgula. Mantenha essa posição vinculada ao texto sem alterações.

O segundo cálculo é:

38:10 = 38 × 60 segundos + 10 segundos = 2.290 segundos.

As duas referências estão separadas por 2.290 − 2.227 = 63 segundos. Essa diferença não cria um intervalo contínuo de cena. O comentário indica dois momentos separados.

Aplique as notas fictícias de visualização

Suponha que as notas fictícias de visualização confirmem uma montagem em 37:07 e seu resultado em 38:10. As duas relações recebem o estado “referência à cena verificada”. R permanece vinculada a C como contexto de resposta. R não recebe uma referência de tempo inventada.

Para um intervalo de interesse de 37:00 até 37:30, inclusive, apenas a primeira relação entra no resultado. A segunda permanece no índice mais amplo. C continua sendo um único comentário em qualquer uma das duas visualizações.

O exemplo tem dois registros de comentários, incluindo uma resposta. C contém duas menções a tempos do vídeo. Essas contagens não estabelecem um número de pessoas.

Deixe um tempo além da duração aguardando análise

Agora considere uma referência candidata fictícia separada, 41:00:

41 × 60 segundos = 2.460 segundos.

2.460 − 2.400 = 60 segundos além da duração do vídeo fictício.

A marcação tem formato válido, mas falha na verificação da duração. Deixe-a aguardando análise e registre o motivo. Não a substitua por 40:00. Essa referência candidata separada não altera as contagens de C e R acima.

8. Verifique a exportação e preserve os estados de falha

Exporte o índice de navegação verificado com a URL do vídeo, o tempo verificado, o ID do comentário, o contexto do comentário ao qual ele responde, uma anotação curta e o estado. Mantenha junto dele as tabelas originais de comentários e de referências candidatas.

Antes de usar o índice, verifique se cada relação leva a um comentário salvo. Verifique novamente as posições das marcações no texto sem alterações. Confirme os cálculos e as unidades. Confira se cada tempo aceito pertence ao vídeo correto.

Mantenha estas falhas visíveis:

Uma contagem igual a zero se aplica apenas ao conjunto que você de fato verificou. Ela não prova que não existem comentários relevantes. Informe os IDs únicos de comentários separadamente das menções a tempos do vídeo. Mantenha a ordem da fonte, os limites, as datas de coleta e os registros pendentes junto dessas contagens.