É possível exportar todos os resultados de busca do Google para uma planilha?

1. Defina o que a planilha deve responder

Substitua “todos os resultados” por uma solicitação que você possa verificar. Por exemplo: “Salve até 10 observações de resultados da busca na web do Google para uma consulta, com as configurações de Estados Unidos e inglês.”

O limite é o número máximo de linhas que a coleta pode salvar para cada consulta executada em cada mecanismo de busca. Ele não garante que a fonte retornará essa quantidade de linhas.

Antes da coleta, registre estas decisões:

1. Informe a finalidade da lista. Você pode precisar de páginas candidatas para analisar um tema ou de evidências dos destinos que apareceram.
2. Salve o texto exato da consulta. Mantenha a grafia, a pontuação e todos os operadores de busca.
3. Selecione o Google como mecanismo de busca para esta primeira exportação.
4. Defina o país e o idioma que deseja solicitar.
5. Defina o limite de linhas e registre se os resultados patrocinados estão incluídos.
6. Defina as verificações que a planilha deve atender antes do uso.

Um operador de busca é um texto, como `site:`, que pede ao mecanismo de busca para restringir uma busca. O mecanismo interpreta esse texto. Um operador não transforma uma busca em um inventário completo de um site.

Deixe clara a questão da fonte. Um mecanismo do Google Custom Search é uma fonte diferente da coleta da busca na web do Google descrita aqui. As evidências fornecidas não comprovam compatibilidade com a API do Google Custom Search. Uma API é uma forma de programas trocarem dados. Uma pergunta pública trata da exportação de um mecanismo personalizado para o Excel, mas essa pergunta não confirma que este Actor oferece esse suporte. Pergunta pública sobre planilhas — observada em 11 de agosto de 2026; data de publicação desconhecida, escopo restrito ao Custom Search

Este método trata de observações da busca pública na web. Ele não comprova cobertura do Maps, volume de buscas, um índice completo da web ou acesso a registros restritos ao proprietário.

2. Salve um conjunto pequeno de dados de entrada antes da coleta

Use os dados de entrada fornecidos abaixo como ponto de partida. JSON é um formato de texto que armazena valores nomeados e listas.

{"country":"US","engines":["google"],"includeSponsoredResults":false,"language":"en","maxResultsPerExecutedQuery":10,"queries":["small business invoice approval workflow"],"safeSearch":true}

Esses dados de entrada passaram por uma verificação das regras de entrada da versão padrão pública. Eles não foram usados em uma execução para este guia. A verificação confirma o formato dos dados de entrada e os valores permitidos. Ela não confirma que o Google retornou resultados. Versão padrão pública 1.0.15 — verificada em 25 de outubro de 2026; regras de entrada inspecionadas, nenhuma execução paga

Substitua os valores do exemplo nesta ordem:

1. Substitua toda a lista `queries` pela consulta desejada. Mantenha uma única consulta para a primeira verificação.
2. Mantenha `engines` definido como `["google"]` para este método.
3. Substitua `country` e `language` se a busca desejada usar outras configurações. `US` solicita Estados Unidos; `en` solicita inglês, quando houver suporte.
4. Defina `maxResultsPerExecutedQuery` com o limite escolhido. O intervalo verificado vai de 1 a 100.
5. Revise `safeSearch` e `includeSponsoredResults` antes de salvar os dados de entrada.

`safeSearch:true` solicita aos mecanismos compatíveis que filtrem resultados com conteúdo explícito. Os mecanismos podem aplicar suas próprias regras locais. `includeSponsoredResults:false` exclui os resultados patrocinados. Se você ativar essa opção, a saída documentada inclui os campos `isSponsored` e `advertiserDomain` para essa finalidade.

Salve todos os dados de entrada junto do registro da coleta. Os campos de saída não substituem o registro dos dados de entrada. Em especial, mantenha a configuração de resultados patrocinados para que outro leitor possa entender quais resultados você solicitou.

Você também pode começar pela Task pública de exportação de resultados de busca para CSV — verificada em 25 de outubro de 2026; presença pública confirmada, dados de entrada salvos não inspecionados. Uma Task é uma predefinição de dados de entrada salva para um Actor. Substitua a consulta de exemplo e confira todas as configurações salvas antes do uso. A verificação da página pública não confirmou se os valores salvos correspondem aos dados de entrada acima.

3. Confira o estado da coleta antes de exportar

Os próximos passos são ações propostas ao leitor. Nenhuma execução do coletor foi feita para este guia.

Depois de iniciar a coleta, confira o estado final e o resumo antes de considerar o conjunto de dados pronto. Um conjunto de dados é a coleção salva de linhas de resultados. Guarde tanto o conjunto de dados quanto o resumo que explica o que ocorreu durante a coleta.

Siga esta sequência:

1. Verifique se a execução terminou com sucesso, falhou ou foi interrompida.
2. Leia o motivo registrado para a parada da coleta.
3. Confira a contagem informada de resultados do Google e todas as informações sobre falhas no mecanismo de busca.
4. Compare a quantidade salva com o limite solicitado.
5. Mantenha junto da exportação todas as informações sobre bloqueios, filtros ou esgotamento da fonte.

Esgotamento da fonte significa que a coleta chegou ao fim dos resultados disponíveis por meio daquela solicitação. Isso não comprova que o Google não tenha outras páginas indexadas.

Mantenha estes estados separados:

Uma execução concluída com menos linhas do que o solicitado precisa de uma explicação. Isso não significa automaticamente que houve falha, nem que a coleta está completa.

Se o conjunto de dados e o resumo divergirem, mantenha os registros originais e reserve a planilha para revisão. Não acrescente linhas em branco para atingir o limite. Não substitua a quantidade realmente salva pelo limite solicitado.

4. Exporte sem alterar os valores da fonte

Exporte CSV ou JSON do conjunto de dados concluído. CSV armazena valores de tabelas em texto, geralmente separados por vírgulas. Guarde o arquivo original baixado antes de editar uma cópia na planilha.

Importe o arquivo pelos controles de importação da planilha. Defina identificadores e endereços da web como texto. Preserve também as sequências de texto originais de data e hora em colunas de texto. A conversão automática de datas ou números pode alterar a forma de um valor e dificultar a comparação com a fonte.

Mantenha estes campos de resultado documentados:

Esses campos vêm do contrato público de saída verificado. Chronometrica Google Search Scraper — verificado em 25 de outubro de 2026; campos documentados, sem verificação em execução

`canonicalUrl` é um endereço candidato normalizado. O nome do campo não comprova que alguém conferiu a tag canônica HTML da página de destino, que identifica o endereço preferencial de uma página. Ele também não comprova qual era o texto ou o endereço original do link.

Um snippet é um trecho de texto de um resultado de busca. Ele não é o texto do artigo obtido da página. A ausência de um snippet não significa que a página de destino esteja vazia. A posição registra onde um resultado apareceu; ela não mede visitas ou tráfego.

Compare algumas linhas importadas com o arquivo original. Inclua os valores disponíveis que contenham vírgulas, aspas, quebras de linha ou caracteres de outros idiomas. Confirme que cada valor permanece na coluna correta.

Se o CSV não preservar a diferença entre um valor ausente e uma sequência de texto vazia, mantenha o JSON como referência da fonte. Registre essa diferença em uma coluna de revisão separada quando a planilha precisar dela.

5. Conte observações e destinos separadamente

A contagem de linhas e a contagem de destinos únicos respondem a perguntas diferentes.

A contagem de observações informa quantos registros de resultados você salvou. A contagem de destinos únicos informa quantos endereços retornados distintos aparecem conforme a regra de contagem declarada.

Na primeira exportação, use as sequências exatas de texto de `canonicalUrl` como regra para distinguir destinos. Isso evita combinar, sem indicação, endereços com caminhos ou parâmetros diferentes. Ainda assim, essa regra conta endereços retornados distintos, não identidades de páginas verificadas de forma independente.

Mantenha a tabela de observações intacta. Crie qualquer lista de destinos em uma tabela de trabalho separada. Se um endereço aparecer duas vezes em posições diferentes nos resultados, mantenha as duas observações e suas posições.

Uma linha repetida na exportação é outra questão. Se o mesmo registro salvo aparecer duas vezes porque você importou o arquivo duas vezes, investigue esse erro de importação. Não use apenas a repetição de endereços de destino para concluir que as observações são cópias duplicadas.

Para a tarefa separada de combinar exportações, consulte Como combinar exportações de busca do Bing sem perder as evidências de consulta e posição. Esse guia trata de exportações do Bing. Suas tabelas separadas de observações e destinos ajudam a explicar a diferença entre as contagens; ele não fornece evidências de execução para este método do Google.

Preserve os valores ausentes em todas as contagens. Uma posição ausente é desconhecida, não é posição zero. Uma contagem de resultados ausente é desconhecida, não é um zero confirmado. Registre zero somente quando as evidências da fonte sustentarem essa contagem dentro do escopo declarado da coleta.

6. Ficção original: 16 observações e 15 destinos

Todo este exemplo resolvido é uma ficção original. A execução, os horários, as posições dos resultados, o endereço de destino e as contagens foram inventados para ensinar. Não se trata de um teste do Actor nem de um resultado de cliente.

Uma pessoa analista usa uma consulta no Google: “small business invoice approval workflow”. Ela solicita as configurações de Estados Unidos e inglês. Mantém a busca segura ativada e os resultados patrocinados desativados.

Somente para este exemplo fictício, ela altera o limite de 10 observações dos dados de entrada fornecidos para 20. A coleta salva 16 observações. O resumo fictício informa esgotamento da fonte.

Duas observações têm o mesmo endereço retornado:

Cada uma das outras 14 observações tem um endereço diferente. Nenhum corresponde ao endereço compartilhado acima.

As contagens conferem da seguinte forma:

• Contagem de observações: 2 observações com um destino compartilhado + 14 outras observações = 16 observações.
• Contagem de destinos únicos: 1 destino compartilhado + 14 outros destinos = 15 destinos.
• Margem não utilizada do limite: 20 observações permitidas − 16 observações salvas = 4 observações abaixo do limite.

Essas quatro observações representam uma margem não utilizada. Não são quatro resultados conhecidos que estão faltando. O limite não informa a quantidade total de resultados correspondentes do Google.

O registro fictício da coleta da pessoa analista contém:

Uma declaração fictícia de cobertura adequada seria:

Não descreva este exemplo como 20 resultados retornados. Não o descreva como todas as páginas indexadas. Dividir 16 pelo limite de 20 compararia as linhas salvas com a quantidade permitida, sem medir a cobertura do Google.

7. Aceite a planilha e registre seus limites

Antes de usar o arquivo em um relatório ou em outro processo, aplique estas verificações de aceitação:

1. Confira a correspondência com a solicitação. Confirme o mecanismo de busca, a consulta executada, o país, o idioma e as configurações salvas nos dados de entrada.
2. Confira as contagens de linhas. Compare a contagem do conjunto de dados original com a contagem de observações importadas. Explique qualquer diferença.
3. Confira os campos. Confirme que a importação preservou os identificadores, os endereços, o texto da consulta e os horários.
4. Separe as contagens. Informe as observações e os destinos únicos conforme uma regra declarada para os endereços.
5. Preserve os valores desconhecidos. Mantenha os valores ausentes distintos de zero e de texto vazio quando a fonte permitir essa distinção.
6. Anexe as evidências do motivo de parada. Registre o estado final, as falhas conhecidas e o motivo do término da coleta.
7. Escreva a declaração de cobertura. Informe o limite, as linhas salvas, os destinos únicos, as configurações, o horário real da verificação e os limites da fonte.

Se os horários das observações estiverem ausentes, informe isso. Se você registrar seu próprio horário de inspeção, identifique-o como tal. Não o coloque em `observedAt` como se tivesse sido fornecido pela fonte.

Uma planilha bem organizada não comprova que as páginas de destino sejam acessíveis ou relevantes. Se o próximo passo for coletar páginas, revise os destinos separadamente. O guia de fila de rastreamento do Bing explica essa tarefa posterior de revisão. Sua fonte de busca é o Bing; use-o para entender a aceitação e a rejeição de destinos, além das verificações ainda sem conclusão.

Adicione outra consulta somente quando ela atender a uma necessidade declarada. Você pode precisar de outro termo sobre o tema ou de outro mercado. Mantenha essa busca como outra amostra definida. Repetir buscas não comprova que a coleta esteja completa.