# Chronometrica vs Streamers: escolha um Actor de busca no YouTube para uma lista limitada de vídeos

Recomendamos o Chronometrica quando você precisa de uma lista limitada de vídeos únicos do YouTube, obtidos por consultas fixas, com a consulta de origem explícita. Seus controles documentados atendem bem a esse trabalho. Escolha o Streamers quando precisar dos filtros de busca nativos, das opções de legendas ou de uma extração mais ampla que ele oferece. Essa é a escolha principal: contabilização do painel de consultas ou controles de busca mais completos. [Contrato do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper), [Contrato do Streamers](https://apify.com/streamers/youtube-scraper)

Um Actor é um programa de coleta de dados hospedado. Esta comparação abrange o nosso Chronometrica YouTube Search Scraper e o Streamers YouTube Scraper. Ela se concentra em 1 resultado: uma lista pequena e útil de vídeos cujas regras de coleta você consegue explicar.

Um painel de busca é um conjunto declarado de consultas coletadas sob uma regra fixa. Por exemplo, você pode coletar 2 consultas com um limite compartilhado. O resultado pode apoiar uma pesquisa, a revisão de fontes ou uma análise posterior de temas. Ele não comprova uma cobertura completa do YouTube.

Os contratos públicos usados aqui foram verificados em 20 de outubro de 2026. A entrada de exemplo passou por uma verificação de esquema. Ela não foi executada, portanto não fornece uma quantidade medida de resultados nem um resultado de desempenho.

## Escolha o que cada linha representa antes de escolher o Actor

Antes de comparar os controles, decida o que cada linha deve representar.

Uma linha de vídeo único representa 1 ID de vídeo distinto. Se o mesmo vídeo aparecer em 2 consultas, uma tabela de vídeos únicos mantém 1 linha salva para esse vídeo.

Uma ocorrência de consulta/vídeo representa um vídeo que aparece em uma consulta específica. O mesmo vídeo pode gerar ocorrências separadas quando aparece em consultas diferentes.

Essas unidades respondem a perguntas diferentes. Uma tabela de vídeos únicos responde: “Quais vídeos distintos este painel coletou?” Uma tabela de ocorrências pode ajudar a responder: “Quais vídeos apareceram em cada consulta?” Você não pode presumir que uma única tabela responda às 2 perguntas por completo.

O Chronometrica limita os vídeos únicos salvos entre as consultas por meio de `maxResults`. Ele remove IDs de vídeo repetidos. Sua saída inclui o contexto da consulta em campos como `rootQuery`, `query` e `querySource`. A saída e o resumo também mantêm a contabilização das consultas. Esses são pontos fortes úteis quando você precisa de uma lista limitada de fontes com uma origem registrada para cada vídeo salvo. [Contrato do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)

A deduplicação, que remove registros repetidos, tem uma consequência direta. Uma linha mantida não consegue preservar todas as ocorrências repetidas de consulta/vídeo. O contexto da consulta ajuda a explicar uma linha, mas uma origem registrada não é uma lista completa de todas as consultas que encontraram o vídeo.

Use o Chronometrica com confiança quando o resultado necessário for essa lista de fontes únicas. Se precisar de uma tabela completa de ocorrências, verifique primeiro como você vai preservá-las. Não presuma que uma exportação deduplicada as contenha.

## Compare os controles que mudam a escolha

Os 2 Actors podem coletar resultados de busca do YouTube e aplicar limites de resultados. A diferença útil está na regra de coleta que seu projeto exige.

| Decisão | Chronometrica | Streamers |
| --- | --- | --- |
| Foco da coleta nesta comparação | Painel de vídeos únicos com contexto explícito das consultas | Busca por palavras-chave, URLs diretas e coleta mais ampla |
| Limites | Limite global de vídeos únicos e controle de páginas | Limites separados para vídeos comuns, Shorts e transmissões |
| Ordem das consultas | Rodadas balanceadas ou sequenciais | Verifique se o esquema atende à sua regra de coleta |
| Controles nativos de busca | Verifique as entradas documentadas do painel | Ordenação, data, tipo de vídeo, duração e outros filtros |
| Opções adicionais | Mantenha esta decisão focada na coleta de resultados de busca | Opções de legendas e recursos opcionais de IA |

Fontes: [Esquema de entrada do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema), [Esquema de entrada do Streamers](https://apify.com/streamers/youtube-scraper/input-schema).

Suponha que seu estudo exija um filtro nativo para o último mês ou um filtro de duração. Considere os controles documentados do Streamers. Não presuma que o Chronometrica tenha uma entrada equivalente. Aplicar um filtro após a coleta muda quais linhas salvas você mantém. Isso não aplica a mesma regra à busca na fonte. [Esquema de entrada do Streamers](https://apify.com/streamers/youtube-scraper/input-schema)

Esta comparação não comprova que o Streamers não tenha contexto das consultas. O motivo para escolher o Chronometrica é seu contrato explícito para o painel. Escolha de acordo com a regra que você precisa aplicar, em vez da quantidade de recursos listados.

## Defina um painel pequeno com configurações explícitas

Comece com uma pergunta que os vídeos coletados possam ajudar a responder. Por exemplo: “Quais vídeos públicos devo revisar para entender como os criadores explicam 2 habilidades básicas de produção?”

Depois, escreva as consultas originais. Mantenha-as separadas de rótulos ou grupos de temas criados depois. Isso permite que outro leitor veja o que você pediu que a fonte retornasse.

A entrada didática a seguir usa 2 consultas propostas. Elas não são termos de busca com dados medidos nem evidências de demanda de compradores.

```json
{
  "queries": [
    "video lighting basics",
    "home audio recording"
  ],
  "maxResults": 6,
  "maxPagesPerQuery": 1,
  "searchDistribution": "balanced",
  "enableQueryExpansion": false
}
```

Defina um painel pequeno com configurações explícitas

Esta entrada solicita no máximo 6 vídeos únicos salvos. Ela permite 1 página de continuação por consulta e usa rodadas balanceadas entre as consultas. A expansão de consultas está desativada, portanto o painel declarado contém 2 consultas originais. A entrada foi verificada em relação ao esquema público, mas não foi executada. 6 é um limite, não uma quantidade prometida de resultados. [Esquema de entrada do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

A regra de formato também importa. O valor padrão de `includeShorts` é `true`. Portanto, este painel pode conter vídeos comuns e Shorts, a menos que você altere essa configuração de forma explícita. Os outros padrões do esquema continuam em vigor, inclusive o enriquecimento de métricas de vídeo. Registre esses padrões junto à definição do painel. Caso contrário, alguém que leia apenas a lista de consultas pode entender de forma errada o que você incluiu. [Esquema de entrada do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Uma Task é uma predefinição de entrada salva. A [Task pública Export YouTube Search Results](https://apify.com/chronometrica/youtube-search-scraper/examples/export-youtube-search-results) oferece um ponto de partida. Antes da coleta, verifique se as configurações dela atendem à regra que você escreveu. Uma predefinição ajuda você a começar; sua pergunta declarada ainda determina as entradas corretas.

## Entenda a coleta balanceada e a sequencial

O Chronometrica oferece 2 valores para `searchDistribution`: `balanced` e `sequential`. O modo balanceado alterna entre as consultas até que o limite global ou os limites da fonte e de páginas encerrem a coleta. O modo sequencial coleta primeiro os resultados das consultas que aparecem antes na lista. [Esquema de entrada do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Escolha rodadas balanceadas quando cada consulta deve ter uma chance de contribuir antes que o limite compartilhado encerre a coleta. Isso é útil quando a lista de consultas representa várias partes de uma mesma pergunta de pesquisa.

Balanceado não significa quantidades iguais de vídeos salvos. As consultas podem retornar quantidades diferentes de candidatos utilizáveis. Elas também podem encontrar o mesmo vídeo. Com 2 consultas e um limite de 6, não prometa 3 vídeos salvos de cada consulta.

Escolha rodadas sequenciais quando a prioridade das consultas fizer parte do planejamento. Coloque a consulta mais importante primeiro. Aceite que ela pode usar uma parte maior do limite compartilhado antes que as consultas seguintes contribuam.

`resultsPerQuery` é um limite máximo por consulta no modo sequencial. Não o use para descrever uma cota fixa no modo balanceado. Verifique o esquema atual antes de adicioná-lo à sua entrada. [Esquema de entrada do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper/input-schema)

Essas escolhas afetam a interpretação da lista salva. Uma contribuição pequena de uma consulta pode refletir a regra de coleta, a sobreposição ou um limite da fonte. Por si só, ela não prova que o tema tenha poucos vídeos relevantes.

## Examine um exemplo fictício de sobreposição

O exemplo a seguir é fictício e apresenta candidatos para análise do leitor. Ele não é uma saída nativa do Actor, uma ordem de coleta observada ou um resultado testado.

A consulta A tem os IDs de vídeos candidatos V1, V2 e V3. A consulta B tem V3, V4 e V5.

Há 6 ocorrências de consulta/vídeo porque cada consulta tem 3 candidatos. Há 5 IDs de vídeo únicos porque V3 aparece nas 2 listas.

A quantidade de ocorrências duplicadas é:

`6 encounters − 5 unique video IDs = 1 duplicate encounter`

A sobreposição contém 1 ID: V3. Um limite global de 6 não prova que existam 6 vídeos distintos nessas listas de candidatos. As listas contêm apenas 5.

Agora suponha que a linha mantida de V3 registre a consulta A como sua origem. Essa linha ajuda a explicar por que V3 aparece na lista de fontes salva. Ela não preserva a ocorrência separada de V3 na consulta B.

Não adicione uma 2ª linha de V3 sem evidências dessa ocorrência. Neste exemplo fictício, as 2 listas de candidatos foram fornecidas para mostrar a diferença. Uma exportação deduplicada real, por si só, pode não fornecer essa evidência.

Isso importa quando você conta as contribuições das consultas. Contar linhas salvas pela origem registrada descreve essas linhas. Isso não conta necessariamente todos os candidatos encontrados por cada consulta.

Isso também importa ao estudar a sobreposição. Você não consegue recuperar a sobreposição exata de 2 conjuntos completos de resultados da fonte usando apenas a exportação deduplicada deles. Declare o que os dados disponíveis sustentam: os vídeos distintos salvos, seu contexto registrado e os limites conhecidos da coleta.

Para uma lista de revisão de fontes, essas podem ser exatamente as unidades certas. Para um estudo de sobreposição, você precisa de evidências que preservem as ocorrências separadas.

## Use um método de coleta em 8 etapas

1. Escreva a pergunta, as consultas e os formatos. Declare qual decisão a lista vai ajudar você a tomar. Copie o texto exato das consultas originais para seu registro de pesquisa. Especifique se o painel inclui vídeos comuns, Shorts ou ambos. Evite mudar a pergunta depois de ver os resultados sem registrar essa mudança.
2. Defina os limites da coleta. Escolha o limite global de vídeos únicos, o limite de páginas e a regra de distribuição. Mantenha a expansão desativada no primeiro painel controlado. Explique por que o limite é adequado à revisão que você consegue fazer. Um limite pequeno é útil quando você consegue inspecionar cada linha salva e corrigir uma consulta ruim antes de ampliar a coleta.
3. Verifique o esquema de entrada nativo. Confirme se o Actor aceita a regra de que você precisa. Não invente uma cota por consulta no modo balanceado, um filtro nativo de data ou um rastreador automático de posições históricas. Se uma regra necessária não tiver uma entrada documentada, resolva essa lacuna antes de tratar o painel como evidência adequada.
4. Colete uma amostra pequena e preserve seu contexto. Guarde uma referência à execução, as configurações declaradas, os IDs dos vídeos, as URLs públicas e as consultas de origem. O Chronometrica documenta `postId` e `postUrl` junto aos campos de consulta. Use os IDs para identificar os vídeos e as URLs para abrir as fontes públicas para revisão. [Contrato do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)
5. Leia a contabilização das consultas e as condições de encerramento. Verifique a contribuição de cada consulta e o que encerrou a coleta. Uma execução concluída ainda pode ter atingido um limite definido ou um limite da fonte. Compare a quantidade salva com o limite declarado, mas não trate uma quantidade menor como prova de cobertura completa. Mantenha o motivo do encerramento junto ao resultado.
6. Separe as ocorrências dos vídeos únicos salvos. Descreva cada contagem com sua unidade real. Mantenha visíveis nas suas notas as consultas sem contribuição clara. Não as remova do painel declarado sem registrar essa decisão. Preserve os valores ausentes como ausentes; não substitua uma contagem ou métrica desconhecida por 0.
7. Revise a relevância antes da análise. Abra as URLs públicas salvas e verifique se os vídeos respondem à sua pergunta. Registre as decisões de inclusão usando uma regra consistente. Se uma consulta retornar principalmente material irrelevante, revise-a de forma explícita e crie uma nova definição de painel. Não misture resultados de consultas alteradas sob uma descrição que permaneceu igual.
8. Mantenha as configurações fixas para observações repetidas. Se coletar novamente, mantenha cada execução separada, com sua data e suas configurações. Isso facilita o exame das mudanças. Uma única coleta não comprova uma tendência. As mudanças nos vídeos salvos também precisam ser interpretadas à luz dos limites definidos, da sobreposição, das rodadas de consultas e dos limites da fonte.

O método fornece mais do que uma lista de links. Ele fornece uma regra de coleta, fontes identificáveis e uma explicação clara do que as linhas representam. Isso basta para tornar a primeira revisão útil sem alegar cobertura completa da busca.

## Leia os campos de posição respeitando seus limites

O Chronometrica documenta `pageIndex` e `pageRank` entre seus campos de saída. `pageRank` se refere apenas à página de resultados em que aparece. Ele não é uma posição estável em toda a consulta. [Contrato do Chronometrica](https://apify.com/chronometrica/youtube-search-scraper)

Mantenha esses campos quando eles ajudarem a explicar os dados retornados. Não renomeie uma posição local da página como uma classificação geral comprovada. Repetir a coleta não elimina esse limite.

O mesmo cuidado se aplica aos dados disponíveis sobre vídeos e canais. Mantenha os valores fornecidos pela fonte e preserve os valores desconhecidos. Uma métrica em branco não mostra que o vídeo não tem atividade.

Depois de revisar a relevância, você pode usar a lista de fontes para outra pergunta. Por exemplo, você pode comparar quais explicações os vídeos selecionados fornecem. Nosso [método de lacunas de temas no YouTube](/pt-BR/articles/lacunas-de-temas-no-youtube/) aborda essa próxima etapa. Mantenha separada a decisão sobre o coletor: primeiro estabeleça o que você coletou, depois decida o que o conteúdo mostra.

## Comece com 2 consultas e inspecione 1 linha

Escolha 2 consultas relevantes e escreva a pergunta de pesquisa que elas ajudam a responder. Defina um limite global pequeno, escolha rodadas balanceadas ou sequenciais e deixe explícita a regra de formato. Use o [Chronometrica YouTube Search Scraper](https://apify.com/chronometrica/youtube-search-scraper) quando esse contrato de vídeos únicos com limite atender ao seu trabalho.

Execute o painel pequeno e depois inspecione 1 linha mantida. Compare o ID do vídeo, a URL pública e a consulta de origem registrada com suas notas de coleta. Leia a contabilização das consultas e a condição de encerramento antes de ampliar o painel. Se o resultado corresponder à regra declarada, amplie o painel com uma compreensão clara do que cada linha salva representa.

## Fontes e leituras adicionais

- [Chronometrica YouTube Search Scraper: contrato público](https://apify.com/chronometrica/youtube-search-scraper)
- [Chronometrica: esquema de entrada atual](https://apify.com/chronometrica/youtube-search-scraper/input-schema)
- [Export YouTube Search Results: Task pública](https://apify.com/chronometrica/youtube-search-scraper/examples/export-youtube-search-results)
- [Streamers YouTube Scraper: contrato público](https://apify.com/streamers/youtube-scraper)
- [Streamers: esquema de entrada atual](https://apify.com/streamers/youtube-scraper/input-schema)
- [Stack Overflow: a pergunta observada sobre coleta de buscas do YouTube](https://stackoverflow.com/questions/45362731/how-can-i-scrape-videos-from-a-youtube-search)