# 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 | `query.txt` | L'indirizzo della pagina che corrisponde. |
| CSV | `query.csv` | `url;rank` |
| CSV+snippet | `query-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, senza riga di intestazione.
- Le colonne sono separate da un punto e virgola `;`. Una cella che contiene un punto e virgola, 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.
- 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

Un file contiene i risultati che il tuo piano mostra - le righe che puoi aprire nella pagina 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). Le righe vengono prese dall'inizio dei risultati.

Quando il piano ha troncato i risultati, l'ultima riga del file lo dice:

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

La riga inizia con `#` ed è scritta nella lingua del sito da cui hai scaricato. 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 costruiscono l'indirizzo di download dentro la pagina, e funziona per dieci minuti nel browser 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: il dominio, poi una colonna per ogni espressione. Più valori trovati sullo stesso sito condividono una cella, uno per riga. Quando i punti del giorno finiscono, l'ultima riga indica da dove continuare. Vedi [Estrazione](https://it.publicwww.com/docs/clusters/extraction/).

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