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; 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. 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. 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: /v1/search con
format=csv o format=txt. Las
antiguas URL de exportación 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 da un archivo de texto con sus dominios, uno por línea.
- Extracción - un CSV separado por comas, no por punto y coma: el dominio y después una columna por expresión. Varios valores encontrados en un mismo sitio comparten celda, uno por línea. Cuando se agotan los puntos del día, la última línea indica por dónde continuar. Consulta Extracción.