Baixar resultados
Toda página de resultados tem botões que baixam o que a busca encontrou: URLs, CSV e CSV+trechos. Quem entrou na conta também tem Cluster, que salva os resultados em vez de baixá-los. As linhas vêm na mesma ordem da página de resultados.
O que cada botão entrega
| Botão | Arquivo | Cada linha |
|---|---|---|
| URLs | query.txt | O endereço da página que correspondeu. |
| CSV | query.csv | url;rank |
| CSV+trechos | query-snippets.csv | url;rank;snippets |
| Cluster | - | Os domínios são salvos como um cluster; a mensagem diz quantos dos resultados entraram. |
O arquivo recebe o nome da consulta, sem tudo o que não for letras latinas, dígitos,
- e _: "static.hotjar.com"
gera statichotjarcom.csv.
O formato
- UTF-8, sem linha de cabeçalho.
- As colunas são separadas por ponto e vírgula
;. Uma célula que contém ponto e vírgula, aspas duplas ou uma quebra de linha vai entre aspas duplas, e as aspas dentro dela são duplicadas. É CSV padrão: uma planilha ou uma biblioteca de CSV lê o arquivo como está, com o ponto e vírgula escolhido como separador. - A posição é o lugar do site no ranking de popularidade. Fica vazia para um site que não tem posição.
- Todos os trechos de uma página ficam em uma única célula, unidos com
.... - Um trecho que começa com
=,+,-ou@ganha um apóstrofo na frente, para que a planilha o mostre em vez de executá-lo como fórmula. Números, como números de telefone, ficam como estão.
Quantas linhas
Um arquivo traz os resultados que o seu plano mostra - as linhas que você pode abrir na página de resultados - até o limite do plano: Resultados por busca ou download para URLs e CSV, Download com trechos (linhas) para CSV+trechos. Os números estão na página Preços. As linhas são tiradas do topo dos resultados.
Quando o plano cortou os resultados, a última linha do arquivo avisa:
# Truncated at the plan limit: 1,000 of 22,694 results.
A linha começa com # e é escrita no idioma do site
de onde você baixou. Não é um resultado: pule-a ao ler o arquivo em um
programa. Quando ela não aparece, o arquivo traz todos os resultados.
Um download é cobrado como a própria busca: uma busca da cota diária e, no CSV+trechos, também um download com trechos - veja cotas e limite de requisições. Quando as buscas do dia acabam, o download traz o que o plano gratuito permite, e a última linha diz que o arquivo foi cortado.
A partir de um script
Os botões montam o endereço de download dentro da página, e ele funciona por dez
minutos no navegador que abriu a página. Para baixar pelo seu próprio código,
use a API: /v1/search com
format=csv ou format=txt. As
URLs de exportação antigas com ?key= mantêm
exatamente o formato antigo: as células não vão entre aspas, não há última linha e um
site sem posição mostra >30M.
Outros downloads
- Um cluster - o ícone de download na lista de clusters gera um arquivo de texto com os domínios dele, um por linha.
- Extração - um CSV separado por vírgulas, não por ponto e vírgula: o domínio e depois uma coluna por expressão. Vários valores encontrados no mesmo site dividem uma célula, um por linha. Quando os pontos do dia acabam, a última linha diz de onde continuar. Veja Extração.