# 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](https://pt.publicwww.com/docs/clusters/creating/); 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](https://pt.publicwww.com/prices.html). 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](https://pt.publicwww.com/docs/api/limits/). 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](https://pt.publicwww.com/docs/api/): `/v1/search` com `format=csv` ou `format=txt`. As [URLs de exportação antigas](https://pt.publicwww.com/docs/api/legacy/) 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](https://pt.publicwww.com/profile/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, com uma linha de cabeçalho: o domínio e depois uma coluna por expressão. Vários valores encontrados no mesmo site dividem uma célula, um por linha. A última linha, que começa com `#`, diz quantos pontos de extração a execução usou; quando os pontos do dia acabam, a linha anterior diz de onde continuar. Veja [Extração](https://pt.publicwww.com/docs/clusters/extraction/).

Source: https://pt.publicwww.com/docs/query-syntax/downloads/