# Scaricare i risultati

Ogni pagina dei risultati ha dei pulsanti che scaricano ciò che la ricerca ha trovato: **URLs**, **CSV** e **CSV+snippet**. Se hai effettuato l'accesso c'è anche **Cluster**, che salva i risultati invece di scaricarli. Le righe arrivano nello stesso ordine della pagina dei risultati.

## Cosa dà ogni pulsante

| Pulsante | File | Ogni riga |
| --- | --- | --- |
| URLs | `statichotjarcom.txt` | L'indirizzo della pagina che corrisponde. |
| CSV | `statichotjarcom.csv` | `url;rank` |
| CSV+snippet | `statichotjarcom-snippets.csv` | `url;rank;snippets` |
| Cluster | - | I domini vengono salvati come [cluster](https://it.publicwww.com/docs/clusters/creating/); il messaggio indica quanti dei risultati sono entrati. |

Il file prende il nome dalla query, tolto tutto tranne lettere latine, cifre, `-` e `_`: `"static.hotjar.com"` dà `statichotjarcom.csv`.

## Il formato

- UTF-8. In CSV e CSV+snippet la prima riga riporta i nomi delle colonne: `url;rank` o `url;rank;snippets`. Il file URLs non ha questa riga.
- Le colonne sono separate da un punto e virgola `;`. Una cella che contiene un punto e virgola, una virgola, una tabulazione, una virgoletta doppia o un a capo viene messa tra virgolette doppie, e una virgoletta al suo interno viene raddoppiata. È CSV standard: un foglio di calcolo o una libreria CSV lo legge così com'è, con il punto e virgola scelto come separatore, e una cella resta intera anche se si sceglie pure la virgola o la tabulazione.
- La posizione è il posto del sito nella classifica di popolarità. È vuota per un sito che non ha posizione.
- Tutti gli snippet di una pagina stanno in un'unica cella, uniti con `...`.
- Uno snippet che inizia con `=`, `+`, `-` o `@` riceve un apostrofo davanti, così un foglio di calcolo lo mostra invece di eseguirlo come formula. I numeri, come i numeri di telefono, restano come sono.

## Quante righe

Le righe vengono prese dall'inizio dei risultati, fino al limite del piano: **Risultati per ricerca o download** per URLs e CSV, **Download con snippet (righe)** per CSV+snippet. I numeri sono nella pagina [Prezzi](https://it.publicwww.com/prices.html). Senza accedere, un file contiene la prima pagina di risultati: fino a 20 righe.

I siti nascosti con il tuo piano - le righe mostrate come **Registrati per vedere** o **Sblocca** - non sono nel file. I risultati sono ordinati per popolarità e i siti nascosti vengono dopo quelli aperti, quindi un file può essere più corto del limite o non avere nessuna riga; in quel caso i pulsanti di download sono inattivi.

Il suggerimento di ogni pulsante dice quante righe avrà il file, per esempio *7 di 1.059 righe: i siti nascosti con il tuo piano non vengono scaricati*. Quando la pagina non mostra dove finiscono le righe aperte, dice *Al massimo*: il file si ferma al primo sito nascosto con il tuo piano, che può arrivare prima.

Quando il file è più corto dei risultati, l'ultima riga dice perché:

```
# Truncated at the plan limit: 1000 of 22694 results.
# 7 of 1059 results: websites hidden on your plan are left out.
```

La prima forma significa che è stato raggiunto il limite di righe del piano, la seconda che i siti nascosti con il tuo piano sono stati esclusi. La riga inizia con `#` ed è scritta nella lingua del sito da cui hai scaricato (gli esempi qui sopra vengono dalla versione inglese); i suoi numeri non hanno il separatore delle migliaia. Non è un risultato: saltala quando leggi il file in un programma. Se non c'è, il file contiene tutti i risultati.

Un download si paga come la ricerca stessa: una ricerca dalla quota giornaliera e, per CSV+snippet, anche un download con snippet - vedi [quote e limiti di frequenza](https://it.publicwww.com/docs/api/limits/). Quando le ricerche del giorno sono esaurite, un download contiene ciò che consente il piano gratuito, e l'ultima riga dice che il file è stato troncato.

## Da uno script

I pulsanti sono link nella pagina dei risultati; l'indirizzo che contengono funziona per dieci minuti dall'indirizzo di rete che ha aperto la pagina. Per scaricare dal tuo codice, usa l'[API](https://it.publicwww.com/docs/api/): `/v1/search` con `format=csv` o `format=txt`. I [vecchi URL di esportazione](https://it.publicwww.com/docs/api/legacy/) con `?key=` mantengono esattamente il loro vecchio formato: le celle non vanno tra virgolette, non c'è l'ultima riga e un sito senza posizione mostra `>30M`.

## Altri download

- **Un cluster** - l'icona di download nell'elenco dei [cluster](https://it.publicwww.com/profile/clusters/) dà un file di testo con i suoi domini, uno per riga.
- **Estrazione** - un CSV separato da virgole, non da punti e virgola, con una riga di intestazione: il dominio, poi una colonna per ogni espressione. Più valori trovati sullo stesso sito condividono una cella, uno per riga. L'ultima riga, che inizia con `#`, dice quanti punti di estrazione ha usato l'esecuzione; quando i punti del giorno finiscono, la riga precedente indica da dove continuare. Vedi [Estrazione](https://it.publicwww.com/docs/clusters/extraction/).

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