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; 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. 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. 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: /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: 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.