Vários cartões de busca se conectam a um índice de páginas separado.

Depois, escolha a Chronometrica se sua planilha ou API precisar que cada item salvo seja uma observação de resultado de busca. Uma API permite que programas troquem dados. Uma observação registra um resultado em seu contexto de busca, incluindo a consulta e a posição. A Chronometrica documenta esse formato de linha e um limite de linhas de resultados para cada mecanismo e consulta. Esse formato dispensa uma etapa separada para transformar resultados aninhados em linhas. Actor da Chronometrica

Continue com o ScraperLink quando precisar de objetos de página, do objeto mesclado opcional ou dos controles documentados `tbs`, `lr` e `cr`. Essas necessidades mudam a recomendação. Actor do ScraperLink

A Chronometrica publica o Actor de sua propriedade incluído nesta comparação. Um Actor é um programa de coleta hospedado. Uma Task é uma configuração de entrada salva para um Actor. Escolhemos esse par para responder a uma pergunta: sua próxima etapa precisa de um objeto de página ou de uma linha para cada resultado?

Comece pela unidade que você está contando

Um item do conjunto de dados é um objeto salvo. Ele nem sempre representa um resultado de busca. Um objeto de página pode conter vários resultados em uma lista. Uma lista armazenada dentro de outro objeto é um array aninhado.

Antes de contar os resultados, identifique o que cada item salvo representa. 2 objetos podem apresentar 2 formas de representar as mesmas observações. Se sua importação expandir ambas, o total poderá superar o número de observações que você pretendia usar.

O relato público de problema do ScraperLink registra a preocupação de um leitor com resultados duplicados. O relato é antigo e está encerrado. Ele fundamenta a dúvida do leitor, mas não comprova um erro ou uma indisponibilidade atual. Relato histórico de resultados duplicados

As especificações públicas dos produtos usadas aqui foram verificadas em 20 de outubro de 2026. Não houve execução de coleta em condições equivalentes nem verificação de resultados ao vivo. Esta comparação explica as entradas e os formatos de saída documentados.

3 contagens respondem a perguntas diferentes:

  • Itens do conjunto de dados: quantos objetos foram salvos?
  • Observações de resultados: quantas entradas de resultados pertencem às buscas selecionadas?
  • Destinos únicos: quantas páginas de destino distintas aparecem nessas entradas?

Escolha o que contar antes de examinar o total. Uma contagem correta de objetos salvos ainda pode dar uma resposta errada sobre os resultados de busca.

Aplique a correção direta à sua solicitação atual

Use esta entrada do ScraperLink para o exemplo fornecido:

json
{
  "keyword": "Nike",
  "limit": "10",
  "page": 1,
  "include_merged": false
}
Aplique a correção direta à sua solicitação atual

A especificação pública de entrada atual aceita essas configurações. Mantenha `limit` como a string mostrada aqui. O exemplo solicita 1 página com limite definido e saída mesclada desativada. Build padrão e esquema de entrada do ScraperLink

Substitua `Nike` pela consulta que pretende usar. Examine a saída antes de enviá-la a outro programa.

Localize a lista de resultados aninhada no item de página selecionado. Conte suas entradas. Depois, verifique qual objeto sua importação lê e qual lista ela expande. A importação deve usar a representação pretendida apenas 1 vez.

Não multiplique o tamanho da lista pelo número de objetos salvos. Primeiro, determine se esses objetos contêm observações distintas ou formas diferentes de representar as mesmas observações.

Mantenha essa primeira solicitação pequena. Seu objetivo é verificar o formato de saída e sua regra de contagem. Se o item de página já funciona na próxima etapa, você resolveu a necessidade imediata. Considere mudar de ferramenta somente depois de definir um requisito separado que o processo atual não atende.

Compare a saída de que sua próxima etapa precisa

Uma regra de aceitação é uma condição que a saída deve atender antes de ser usada. Use a tabela para escrever essa regra. A linha de entrada lista configurações para estes exemplos; ela não afirma que todos os campos são obrigatórios.

Compare a saída de que sua próxima etapa precisa
Critério de decisãoSolicitação atual baseada em páginasLinhas de resultados da Chronometrica
Entrada necessária para este exemplo`keyword`, `limit`, `page`, `include_merged:false``queries`, `engines`, `maxResultsPerExecutedQuery`, `country`, `language`
Unidade de saídaItem de página com resultados aninhados1 observação de resultado de busca por linha do conjunto de dados
Regra de aceitaçãoContar as entradas da lista de resultados selecionada apenas 1 vezCada linha aceita representa 1 observação com contexto de busca
Regra para valores ausentesPreservar valores desconhecidosPreservar valores desconhecidos
Condição de escolhaSua próxima etapa aceita objetos de página ou expande suas listasSua próxima etapa exige linhas de resultados sem expandir listas aninhadas

As colunas dos produtos usam as especificações documentadas atuais. Actor do ScraperLink, Actor da Chronometrica, Esquema de entrada da Chronometrica

Expandir significa transformar cada entrada de uma lista aninhada em uma linha separada. Durante a expansão, preserve o contexto de busca de cada entrada.

Uma etapa de expansão que funciona pode continuar no seu processo. A escolha depende do sistema que recebe os dados. Se ele aceita objetos de página, mudar o formato de saída pode não trazer benefício. Se ele exige observações individuais, decida entre manter a etapa de expansão ou receber diretamente os dados nesse formato de linha.

Exemplo fictício: 2 objetos não comprovam 20 resultados

Este exemplo é fictício. Ele não é um teste de produto, um resultado medido nem um caso de cliente.

Um analista solicita 1 página. Neste exemplo inventado, a página bruta contém 10 observações de resultados aninhadas. Um objeto mesclado opcional repete essas mesmas 10 observações.

O analista vê 2 objetos salvos. Sua importação expande ambos:

text
10 observations from the raw page
+ 10 repeated observations from the merged object
= 20 imported sightings
Exemplo fictício: 2 objetos não comprovam 20 resultados

A conta está correta: 10 + 10 = 20. A interpretação está errada. A contagem pretendida para essa única página é de 10 observações. A planilha contém 2 cópias de cada observação porque a importação usou ambas as representações.

O analista desativa a saída mesclada. Em seguida, lê a lista de resultados da página bruta apenas 1 vez e verifica seu tamanho. Neste exemplo fictício, isso evita a expansão dupla.

Este exemplo não mostra que um Actor buscou uma página 2 vezes ou cobrou 2 vezes. A contagem de objetos salvos, por si só, não comprova nenhum desses eventos.

Mais adiante, o analista precisa fazer uma escolha quando outra API exige que cada item enviado represente 1 observação. Ele pode manter a etapa de expansão ou escolher um Actor cuja saída documentada já atenda a esse requisito.

A Chronometrica atende a esse requisito posterior de formato em linhas. O total inventado não oferece evidência de vantagem no desempenho da coleta.

Quando a Chronometrica atende à sua necessidade

A Chronometrica documenta 1 observação de resultado de busca por linha do conjunto de dados, com mecanismo, consulta, posição e contexto. Ela também documenta `maxResultsPerExecutedQuery`, que define um limite de linhas de resultados para cada combinação executada de mecanismo e consulta. Actor da Chronometrica

Use este exemplo de entrada fornecido como ponto de partida:

json
{
  "queries": [
    "Nike"
  ],
  "engines": [
    "google"
  ],
  "maxResultsPerExecutedQuery": 10,
  "country": "US",
  "language": "en"
}
Quando a Chronometrica atende à sua necessidade

As chaves, os campos obrigatórios, os valores permitidos, os limites das listas e os limites numéricos foram conferidos no esquema público atual. Este exemplo não foi executado. Build padrão e esquema de entrada da Chronometrica

O limite define um máximo. Ele não comprova que uma solicitação retornará exatamente 10 observações. Verifique a saída real antes de informar sua contagem.

Esse formato atende a uma planilha que armazena 1 observação em cada linha. Ele também atende a uma API que espera 1 observação em cada item enviado. A unidade salva corresponde à unidade de que a próxima etapa precisa.

Essa correspondência elimina a necessidade de expandir primeiro uma lista de resultados aninhada. Você ainda precisa selecionar os campos usados pelo seu sistema, preservar valores desconhecidos e verificar a saída. Também pode precisar de uma lista separada de destinos únicos.

Escolha a Chronometrica por essa adequação verificada. As evidências disponíveis não comprovam vantagem de velocidade, confiabilidade, precisão ou custo. Confirme qualquer outro recurso necessário na documentação atual antes de mudar.

Faça 5 verificações antes de mudar de ferramenta

  1. Leia a configuração atual da saída mesclada. Identifique de qual representação da saída seu processo precisa. Trate o problema imediato de contagem separadamente da escolha posterior do formato de linha.
  2. **Solicite 1 página com limite definido e `include_merged:false`.** Registre a entrada exata. Isso permite relacionar a saída à consulta e à página solicitadas.
  3. Conte as entradas de resultados aninhadas. Examine a lista de resultados da página bruta selecionada. Verifique se sua importação lê essa lista apenas 1 vez. Compare o número de entradas com o número de linhas criadas pela expansão.
  4. Defina a unidade exigida pela próxima etapa. Escreva uma frase, como: “Cada linha importada deve representar 1 resultado de 1 consulta exata.” Use essa frase como sua regra de aceitação.
  5. Preserve o contexto de busca antes de criar uma lista de destinos únicos. Mantenha o mecanismo, a consulta exata, a posição e as informações de data e hora disponíveis. Identifique qualquer data e hora registrada pelo seu próprio processo como um registro feito por você.

Essas verificações levam a 2 decisões. Primeiro, decida se você consegue contar corretamente a saída atual. Depois, decida se a unidade salva atende ao próximo sistema.

Em uma planilha manual, pode ser fácil examinar uma etapa de expansão. Em uma importação recorrente, receber diretamente linhas de resultados pode atender melhor ao sistema que recebe os dados. Verifique o trabalho exigido pelo seu processo antes de presumir uma economia de tempo.

Se você comparar custos mais adiante, defina a unidade de cobrança separadamente. Um objeto salvo, uma observação de resultado e uma busca cobrada são conceitos diferentes. O total da saída mesclada não comprova o número de buscas cobradas nem uma vantagem de preço.

Verifique a importação antes de usar seus totais

Defina uma regra de aceitação específica o suficiente para ser verificada. “A saída parece correta” ajuda pouco quando os totais diferem. Uma regra útil identifica a lista de origem, a unidade contada e o contexto que cada linha importada deve preservar.

Comece pela saída selecionada antes da expansão. Conte as observações que pretende usar. Depois, examine as linhas criadas a partir dessa saída. Se esses totais diferirem, verifique quais objetos e listas a importação lê antes de remover linhas.

Uma regra que exclui URLs repetidas pode ocultar a causa de um erro de contagem. Ela também pode remover observações válidas de consultas distintas. Primeiro, corrija a seleção das representações da saída. Crie uma lista de destinos únicos somente quando precisar dessa contagem separada.

Registre o resultado da verificação em termos claros. Informe se você contou objetos de página, observações ou destinos. Isso torna o total útil para quem não examinou a saída original.

Mantenha as observações separadas dos destinos únicos

O mesmo destino pode aparecer em consultas diferentes. Essas ocorrências podem ser observações distintas, mesmo quando apontam para a mesma página.

Uma lista de destinos únicos informa quais páginas apareceram. Os registros de observações informam onde uma página apareceu em cada consulta e posição. Mantenha ambas as saídas quando precisar das 2 respostas.

Crie a lista de destinos a partir dos registros de observações. Preserve esses registros para poder rastrear um destino até seu contexto de busca. Não exclua uma observação apenas porque sua URL também apareceu em outra consulta.

Essa distinção também ajuda quando 2 pessoas informam totais diferentes. Uma pode ter contado observações, enquanto a outra contou destinos. Informe a unidade antes de tratar esses totais como resultados conflitantes.

Para a tarefa posterior de combinar exportações de várias execuções, consulte Como mesclar exportações de buscas do Bing sem perder as evidências de consulta e posição. Esse guia trata da mesclagem entre execuções. Esta comparação começa antes, na escolha entre representações da saída e unidades salvas.

Preserve valores desconhecidos durante a importação

Um valor ausente não significa 0. Uma posição ausente não deve virar posição 0. Uma contagem desconhecida não deve virar uma contagem confirmada de 0.

Deixe um valor desconhecido em branco ou use a forma de representar valores ausentes aceita pelo sistema que recebe os dados. Documente essa escolha para que cálculos posteriores não tratem dados ausentes como um resultado medido.

Aplique a mesma regra à data e à hora. Não invente uma data e hora da fonte. Se você sabe apenas quando seu próprio processo recebeu os dados, armazene essa data e hora com uma identificação clara.

Verifique essas regras em qualquer um dos formatos de saída. Linhas separadas podem ser mais fáceis de aceitar para o sistema que recebe os dados, mas ainda precisam de interpretação correta. Uma contagem válida de linhas não comprova que todos os campos estão presentes nem que cada valor tem o significado presumido no seu relatório.

Fontes e leituras adicionais

Por Chronometrica · Atualizado

Voltar ao topo ↑