Ergebnisse herunterladen
Jede Ergebnisseite hat Schaltflächen, die herunterladen, was die Suche gefunden hat: URLs, CSV und CSV+Schnipsel. Mit angemeldetem Konto gibt es außerdem Cluster, das die Ergebnisse speichert, statt sie herunterzuladen. Die Zeilen kommen in derselben Reihenfolge wie auf der Ergebnisseite.
Was jede Schaltfläche liefert
| Schaltfläche | Datei | Jede Zeile |
|---|---|---|
| URLs | query.txt | Die Adresse der Seite, die gepasst hat. |
| CSV | query.csv | url;rank |
| CSV+Schnipsel | query-snippets.csv | url;rank;snippets |
| Cluster | - | Die Domains werden als Cluster gespeichert; die Meldung nennt, wie viele der Ergebnisse aufgenommen wurden. |
Die Datei ist nach der Suchanfrage benannt, aus der alles außer lateinischen
Buchstaben, Ziffern, - und _ entfernt wird:
"static.hotjar.com" ergibt statichotjarcom.csv.
Das Format
- UTF-8, ohne Kopfzeile.
- Die Spalten sind durch ein Semikolon
;getrennt. Eine Zelle, die ein Semikolon, ein doppeltes Anführungszeichen oder einen Zeilenumbruch enthält, steht in doppelten Anführungszeichen, und ein Anführungszeichen darin wird verdoppelt. Das ist Standard-CSV: Eine Tabellenkalkulation oder eine CSV-Bibliothek liest es unverändert, wenn das Semikolon als Trennzeichen gewählt ist. - Rank ist die Position der Website in der Popularitätsrangliste. Bei einer Website ohne Rang ist das Feld leer.
- Alle Schnipsel einer Seite stehen in einer Zelle, verbunden mit
.... - Ein Schnipsel, der mit
=,+,-oder@beginnt, bekommt einen Apostroph vorangestellt, damit eine Tabellenkalkulation ihn anzeigt, statt ihn als Formel auszuführen. Zahlen wie Telefonnummern bleiben unverändert.
Wie viele Zeilen
Eine Datei enthält die Ergebnisse, die Ihr Tarif offenlegt - die Zeilen, die Sie auf der Ergebnisseite öffnen können -, bis zum Limit des Tarifs: Ergebnisse pro Suche oder Download für URLs und CSV, Download mit Schnipseln (Zeilen) für CSV+Schnipsel. Die Zahlen stehen auf der Seite Preise. Die Zeilen werden vom Anfang der Ergebnisse genommen.
Hat der Tarif die Ergebnisse gekürzt, sagt das die letzte Zeile der Datei:
# Truncated at the plan limit: 1,000 of 22,694 results.
Die Zeile beginnt mit # und ist in der Sprache der Website
geschrieben, von der Sie heruntergeladen haben. Sie ist kein Ergebnis:
Überspringen Sie sie, wenn Sie die Datei in ein Programm einlesen. Fehlt sie,
enthält die Datei alle Ergebnisse.
Ein Download wird wie die Suche selbst berechnet: eine Suche aus dem Tageskontingent, bei CSV+Schnipsel zusätzlich ein Download mit Schnipseln - siehe Kontingente und Ratenlimits. Sind die Suchen des Tages aufgebraucht, enthält ein Download so viel, wie der kostenlose Tarif erlaubt, und die letzte Zeile sagt, dass die Datei gekürzt wurde.
Aus einem Skript
Die Schaltflächen erzeugen die Download-Adresse in der Seite selbst, und sie
funktioniert zehn Minuten lang in dem Browser, der die Seite geöffnet hat. Um aus
eigenem Code herunterzuladen, verwenden Sie die API:
/v1/search mit format=csv oder
format=txt. Die alten Export-URLs
mit ?key= behalten ihr altes Format exakt bei: Zellen stehen nicht in
Anführungszeichen, es gibt keine letzte Zeile, und eine Website ohne Rang zeigt
>30M.
Weitere Downloads
- Ein Cluster - das Download-Symbol in der Liste der Cluster liefert eine Textdatei mit seinen Domains, eine pro Zeile.
- Extraktion - eine CSV mit Kommas als Trennzeichen, nicht Semikolons: die Domain, dann eine Spalte pro Ausdruck. Mehrere auf einer Website gefundene Werte teilen sich eine Zelle, einer pro Zeile. Gehen die Punkte des Tages aus, sagt die letzte Zeile, wo es weitergeht. Siehe Extraktion.