
A pergunta principal é simples: você precisa ler o que as pessoas escreveram nas respostas? Uma contagem pode indicar que uma pergunta recebeu respostas. Ela não mostra se essas respostas contêm uma correção, outra pergunta ou uma resposta útil.
Essa diferença importa quando você reúne comentários de um tutorial. A pergunta pública que motivou esta comparação trata de como coletar os comentários de um tutorial. Ela não demonstra que toda análise precisa incluir respostas. Defina a pergunta da sua própria análise antes de escolher uma ferramenta. Discussão pública
Este guia compara as especificações públicas documentadas, consultadas em 20 de outubro de 2026. Ele mostra como escolher um tipo de resultado, definir limites de coleta e contar as linhas retornadas. Ele não apresenta um teste de coleta.
Escolha as evidências de que sua análise precisa
Um comentário de nível superior inicia uma conversa. Uma resposta participa dessa conversa. O comentário pai é o comentário ao qual uma resposta pertence.
Na análise de um tutorial, esses 2 tipos de linha podem responder a perguntas diferentes. O texto dos comentários de nível superior pode mostrar as perguntas iniciais dos espectadores. O texto das respostas pode mostrar como outros espectadores respondem a essas perguntas. Um vínculo com o comentário pai mantém essas partes conectadas.
Escreva a pergunta da sua análise em 1 frase. Por exemplo: “Preciso ler as respostas que os espectadores deram às perguntas sobre esta aula.” Essa frase exige o texto das respostas. “Preciso ordenar as perguntas iniciais pelo número de respostas” exige uma contagem, mas pode não exigir as respostas em si.
Não colete texto extra só porque uma ferramenta pode retorná-lo. Mais linhas exigem mais trabalho de leitura. Cada resposta também precisa de contexto suficiente da conversa para fazer sentido. Uma resposta curta, como “Isso funcionou”, pode ser difícil de interpretar sem o comentário pai.
Para uma análise que precisa desse contexto, a Chronometrica documenta as respostas como linhas separadas. Os campos relevantes incluem `parentCommentId`, `isReply`, `replyDepth` e `replyCount`. Esses campos permitem distinguir uma linha de resposta do comentário ao qual ela pertence. Especificação da Chronometrica
Um Actor é um programa de coleta de dados executado em um serviço de hospedagem. A escolha aqui depende do que a saída precisa conter. Primeiro, escolha as evidências necessárias. Depois, escolha o Actor que documenta essas evidências.
Compare os tipos de resultado documentados
A tabela a seguir se concentra na decisão que muda a recomendação.
| Critério de decisão | Chronometrica | CheapAPI |
|---|---|---|
| Linhas de comentários | Comentários de nível superior e linhas separadas para respostas | Apenas comentários de nível superior |
| Informações sobre respostas | Texto das respostas e campos de vínculo com o comentário pai | Contagens de respostas; sem o texto das respostas |
| Limite de comentários de nível superior por vídeo | 1–1.000 | 1–700 |
| Limite de respostas | 1–100 por comentário pai quando as respostas estão ativadas | Sem linhas com o texto das respostas |
| Outros controles relevantes | Limites separados para comentários de nível superior e respostas | Mínimo de curtidas, mínimo de respostas, palavras-chave, datas e modo de coletar apenas novos comentários |
Fontes: especificação da Chronometrica, esquema de entrada da Chronometrica, especificação da CheapAPI, esquema de entrada da CheapAPI.
Um esquema é a lista dos campos de entrada aceitos e de suas regras. Consulte-o ao preparar uma entrada, pois os controles do produto podem mudar.
Os limites diferentes não demonstram uma vantagem de preço ou velocidade. Eles descrevem quanto cada entrada permite que o Actor colete. Os comentários públicos disponíveis e os controles selecionados também afetam o resultado.
Um tipo de linha com menos informações pode ser a escolha correta. Se uma análise usa apenas as perguntas iniciais, adicionar o texto das respostas pode aumentar o trabalho de leitura sem melhorar a decisão. Se uma análise precisa avaliar respostas dentro das conversas, uma contagem de respostas deixa de fora o texto necessário.
Mantenha essa distinção separada de outras questões sobre os produtos. Esta comparação não demonstra diferenças de velocidade, custo ou abrangência da coleta.
Defina limites separados antes de coletar
A Chronometrica usa `maxCommentsPerVideo` para o limite de comentários de nível superior. O campo aceita valores de 1 a 1.000. Quando `includeReplies` é true, `maxRepliesPerComment` aceita valores de 1 a 100. O limite de comentários de nível superior e o limite de respostas são separados. Esquema de entrada da Chronometrica
Essa distinção muda o planejamento de uma exportação. Um limite de comentários de nível superior não se torna um limite total de linhas quando as respostas estão ativadas. Cada comentário pai selecionado pode acrescentar linhas de respostas, até o limite de respostas configurado.
Para 1 vídeo, calcule o máximo permitido assim:
`top-level cap + (top-level cap × reply cap)`
Use esse cálculo para estimar o maior resultado permitido por essas 2 configurações. Ele é um limite superior, ou seja, um máximo nas condições declaradas. Ele não prevê o número de linhas que você receberá.
Um limite útil deve refletir sua capacidade de análise. Decida quantas perguntas iniciais você consegue examinar. Depois, decida quantas respostas a cada pergunta precisa ler. Registre os 2 números antes da coleta. Isso facilita a explicação do relatório posterior.
Se você ampliar o trabalho, guarde as configurações de cada coleta. Caso contrário, um resultado maior pode parecer indicar mais discussão quando apenas reflete um limite de coleta mais alto. As configurações fazem parte das evidências necessárias para interpretar a contagem de linhas.
Comece com 1 vídeo público relevante
A entrada a seguir usa os campos atuais documentados. Ela ativa as respostas e define limites pequenos e separados:
{
"startUrls": [
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
],
"maxCommentsPerVideo": 2,
"includeReplies": true,
"maxRepliesPerComment": 2
}A URL ilustra o formato da entrada. Substitua-a por um vídeo público relevante. Sua presença neste exemplo não comprova que os comentários estejam disponíveis no momento. Esquema de entrada da Chronometrica
A Chronometrica também oferece uma Task pública de comentários e respostas. Uma Task é uma configuração de entrada salva. Use-a como ponto de partida para a entrada. Depois, confira se as configurações atendem à pergunta da sua análise. Task de exportação de comentários e respostas
A primeira coleta tem um objetivo específico: confirmar que os campos retornados permitem fazer a análise pretendida. Verifique se você consegue identificar as linhas de respostas e vinculá-las aos comentários pai. Leia os textos vinculados em conjunto para verificar se a conexão fornece contexto suficiente.
Uma entrada válida, por si só, não prova que o resultado contém as evidências necessárias. Examine a saída antes de adicionar mais vídeos. Uma primeira coleta pequena facilita essa verificação, pois você pode acompanhar os registros manualmente.
Examine um resultado fictício de 5 linhas
Este exemplo é fictício. Ele não representa uma execução de Actor, um teste comparativo nem o resultado de um cliente.
A análise seleciona 2 comentários de nível superior. O primeiro tem 2 respostas coletadas. O segundo tem 1 resposta coletada. Portanto, a exportação contém:
- 2 linhas de comentários de nível superior.
- 3 linhas de respostas.
- 5 linhas no total.
Para a leitura, identifique os comentários pai como A e B. Coloque as 2 primeiras respostas abaixo de A e a resposta restante abaixo de B. Esses rótulos servem apenas para explicar o exemplo. Eles não são uma proposta de campos de saída.
As respostas representam `3 / 5 × 100 = 60%` das linhas deste resultado fictício. Essa porcentagem descreve apenas as linhas coletadas. Ela não descreve autores únicos, todos os comentários do vídeo nem todos os espectadores. Uma pessoa pode escrever mais de 1 linha.
Com um limite de 2 comentários de nível superior e de 2 respostas por comentário pai, o limite superior aritmético é de `2 + (2 × 2) = 6` linhas. O resultado fictício contém 5. Os limites permitem 6 linhas; eles não prometem 6.
Agora suponha que 1 dessas respostas fictícias corrija uma resposta do tutorial. Ler essa resposta pode mudar a análise. Uma linha de comentário pai que contém apenas uma contagem de respostas não mostra o texto da correção. Essa é a razão prática para exigir o texto das respostas.
Se a análise só precisa identificar perguntas iniciais que receberam respostas, a contagem pode ser suficiente. A mesma conversa fictícia pode justificar escolhas de coleta diferentes, pois as perguntas de pesquisa são diferentes.
O exemplo também mostra por que os totais da coleta precisam de rótulos claros. “5 linhas coletadas, incluindo 3 respostas” descreve este resultado. “5 espectadores” ou “todos os 5 comentários” afirmariam fatos que o exemplo não comprova.
Use um método de coleta e análise em pequena escala
Use este método para transformar a escolha do produto em um resultado que você possa verificar.
- Defina o que precisa ler. Registre se você precisa ler as respostas ou apenas avaliar as perguntas de nível superior. Indique qual decisão o texto vai orientar. Se o conteúdo das respostas puder mudar essa decisão, inclua-o nos requisitos.
- Declare os limites. Defina o limite de comentários de nível superior e, quando necessário, o limite de respostas. Calcule o máximo permitido antes da coleta. Guarde os limites ao lado da URL do vídeo nas suas notas de análise para que outra pessoa possa interpretar o resultado.
- Mantenha os vínculos entre registros. Preserve os IDs dos comentários e os vínculos com os comentários pai na exportação. Um ID identifica um registro. Um vínculo com o comentário pai conecta uma resposta ao comentário ao qual ela pertence. Remover esses campos pode dificultar o agrupamento posterior, mesmo que o texto continue legível.
- Separe os tipos de linha. Leia os comentários de nível superior e as respostas como tipos diferentes de registro. A Chronometrica documenta `isReply` e `parentCommentId` entre os campos relevantes. Confira esses campos no resultado retornado antes de criar contagens ou grupos. Especificação da Chronometrica
- Agrupe as respostas para a leitura. Coloque cada resposta abaixo de seu comentário pai usando o vínculo preservado. Mantenha visível qualquer vínculo não resolvido. Se o comentário pai necessário não estiver na exportação, não tente adivinhar qual comentário fornece o contexto. Marque o caso para revisão.
- Conte cada linha coletada 1 vez. Informe o número de linhas de comentários de nível superior, o número de linhas de respostas e a soma desses números. Mantenha `replyCount` separado desse cálculo. Ele é um campo de contagem, não um conjunto adicional de linhas de texto coletadas.
- Verifique se as evidências respondem à pergunta. Leia o resultado pequeno antes de ampliar a coleta. Confirme que o texto e os vínculos necessários estão presentes. Se a análise exige apenas o texto dos comentários de nível superior, reavalie se coletar respostas acrescenta evidências úteis.
Essas etapas produzem um resultado que outra pessoa pode examinar. Elas também mantêm as escolhas de coleta separadas das conclusões sobre a discussão. Um comentário pai ausente é um problema de contexto que deve ser informado. Um total pequeno de linhas é um resultado de coleta que deve ser explicado. Nenhum dos 2 justifica inventar uma resposta sobre o vídeo.
Mantenha as contagens de respostas separadas das respostas coletadas
Um erro comum de contagem é somar o `replyCount` de um comentário pai às linhas de respostas já presentes na exportação. Isso pode contar a mesma discussão 2 vezes.
Mantenha 2 medidas separadas. A primeira é o número de linhas de respostas que você de fato coletou. A segunda é a contagem de respostas armazenada em um registro de comentário. Identifique cada medida com clareza. Não suponha que a contagem armazenada seja igual ao número de linhas de respostas na sua exportação.
Um limite de coleta pode permitir menos linhas de respostas do que a conversa contém. Por isso, o resultado deve preservar a diferença entre o texto que você pode examinar e uma contagem que pode informar. Apenas o texto coletado pode sustentar uma afirmação sobre o que uma resposta específica diz.
Preserve os valores desconhecidos. Se um campo estiver ausente, não o substitua por 0. O valor 0 faz uma afirmação específica sobre a quantidade. Um valor ausente indica que a quantidade não é conhecida a partir daquele campo.
Tenha o mesmo cuidado com os vínculos com comentários pai. Mantenha as respostas cujo comentário pai não foi identificado em um grupo de revisão visível. O texto ainda pode ser útil, mas a exportação não forneceu a conexão completa necessária para ler a conversa com segurança.
Fontes e leituras adicionais
Por Chronometrica · Atualizado
Voltar ao topo ↑