# Descargar resultados

Cada página de resultados tiene botones que descargan lo que encontró la búsqueda: **URLs**, **CSV** y **CSV+fragmentos**. Con la sesión iniciada también está **Clúster**, que guarda los resultados en lugar de descargarlos. Las filas llegan en el mismo orden que en la página de resultados.

## Qué da cada botón

| Botón | Archivo | Cada línea |
| --- | --- | --- |
| URLs | `query.txt` | La dirección de la página que coincidió. |
| CSV | `query.csv` | `url;rank` |
| CSV+fragmentos | `query-snippets.csv` | `url;rank;snippets` |
| Clúster | - | Los dominios se guardan como un [clúster](https://es.publicwww.com/docs/clusters/creating/); el mensaje indica cuántos de los resultados entraron. |

El archivo se llama como la consulta, sin nada que no sean letras latinas, cifras, `-` y `_`: `"static.hotjar.com"` da `statichotjarcom.csv`.

## El formato

- UTF-8, sin fila de encabezado.
- Las columnas se separan con punto y coma `;`. Una celda que contiene un punto y coma, unas comillas dobles o un salto de línea va entre comillas dobles, y las comillas que lleve dentro se duplican. Es CSV estándar: una hoja de cálculo o una biblioteca CSV lo lee tal cual, con el punto y coma elegido como separador.
- La posición es el lugar del sitio en el ranking de popularidad. Queda vacía para un sitio que no tiene posición.
- Todos los fragmentos de una página van en una sola celda, unidos con `...`.
- Un fragmento que empieza por `=`, `+`, `-` o `@` lleva un apóstrofo delante, para que una hoja de cálculo lo muestre en lugar de ejecutarlo como fórmula. Los números, como los de teléfono, se dejan tal cual.

## Cuántas filas

Un archivo contiene los resultados que muestra tu plan - las filas que puedes abrir en la página de resultados - hasta el límite del plan: **Resultados por búsqueda o descarga** para URLs y CSV, **Descarga con fragmentos (filas)** para CSV+fragmentos. Las cifras están en la página [Precios](https://es.publicwww.com/prices.html). Las filas se toman desde el principio de los resultados.

Cuando el plan recortó los resultados, la última línea del archivo lo indica:

```
# Truncated at the plan limit: 1,000 of 22,694 results.
```

La línea empieza por `#` y está escrita en el idioma del sitio desde el que descargaste. No es un resultado: sáltala al leer el archivo desde un programa. Si no aparece, el archivo contiene todos los resultados.

Una descarga se cobra igual que la propia búsqueda: una búsqueda de la cuota diaria y, con CSV+fragmentos, también una descarga con fragmentos - consulta [cuotas y límites de frecuencia](https://es.publicwww.com/docs/api/limits/). Cuando se agotan las búsquedas del día, una descarga trae lo que permite el plan gratuito, y la última línea indica que el archivo se recortó.

## Desde un script

Los botones construyen la dirección de descarga dentro de la página, y funciona durante diez minutos en el navegador que abrió la página. Para descargar desde tu propio código, usa la [API](https://es.publicwww.com/docs/api/): `/v1/search` con `format=csv` o `format=txt`. Las [antiguas URL de exportación](https://es.publicwww.com/docs/api/legacy/) con `?key=` mantienen exactamente su formato de siempre: las celdas no van entre comillas, no hay última línea y un sitio sin posición muestra `>30M`.

## Otras descargas

- **Un clúster** - el icono de descarga en la lista de [clústeres](https://es.publicwww.com/profile/clusters/) da un archivo de texto con sus dominios, uno por línea.
- **Extracción** - un CSV separado por comas, no por punto y coma, con fila de encabezado: el dominio y después una columna por expresión. Varios valores encontrados en un mismo sitio comparten celda, uno por línea. La última línea, que empieza por `#`, indica cuántos puntos de extracción usó la ejecución; cuando se agotan los puntos del día, la línea anterior indica por dónde continuar. Consulta [Extracción](https://es.publicwww.com/docs/clusters/extraction/).

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