# 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 | `statichotjarcom.txt` | La dirección de la página que coincidió. |
| CSV | `statichotjarcom.csv` | `url;rank` |
| CSV+fragmentos | `statichotjarcom-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. En CSV y CSV+fragmentos, la primera línea nombra las columnas: `url;rank` o `url;rank;snippets`. El archivo de URLs no tiene esa línea.
- Las columnas se separan con punto y coma `;`. Una celda que contiene un punto y coma, una coma, un tabulador, 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, y una celda se mantiene entera aunque también se elija la coma o el tabulador.
- 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

Las filas se toman desde el principio de los 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). Sin iniciar sesión, un archivo contiene la primera página de resultados: hasta 20 filas.

Los sitios ocultos en tu plan - las filas que aparecen como **Regístrate para ver** o **Mejora tu plan para ver** - no están en el archivo. Los resultados van por popularidad y los sitios ocultos vienen después de los abiertos, así que un archivo puede ser más corto que el límite o no tener ninguna fila; entonces los botones de descarga están inactivos.

El texto de ayuda de cada botón indica cuántas filas tendrá el archivo, por ejemplo *7 de 1.059 filas: no se descargan los sitios ocultos en tu plan*. Cuando la página no muestra dónde terminan las filas abiertas, dice *Como máximo*: el archivo termina en el primer sitio oculto en tu plan, que puede llegar antes.

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.

## Desde un script

Los botones son enlaces en la página de resultados; la dirección que llevan funciona durante diez minutos desde la dirección de red 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 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. Consulta [Extracción](https://es.publicwww.com/docs/clusters/extraction/).

Source: https://es.publicwww.com/docs/search/downloads/
