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

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. 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. 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: /v1/search con format=csv o format=txt. I vecchi URL di esportazione 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 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.