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

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. Bei CSV und CSV+Schnipsel nennt die erste Zeile die Spalten: url;rank oder url;rank;snippets. Die URLs-Datei hat keine solche Zeile.
• Die Spalten sind durch ein Semikolon ; getrennt. Eine Zelle, die ein Semikolon, ein Komma, einen Tabulator, 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, und eine Zelle bleibt ganz, auch wenn zusätzlich das Komma oder der Tabulator 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

Die Zeilen werden vom Anfang der Ergebnisse genommen, 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. Ohne Anmeldung enthält eine Datei die erste Ergebnisseite: bis zu 20 Zeilen.

In Ihrem Tarif ausgeblendete Websites - die Zeilen, die als Zum Ansehen registrieren oder Zum Ansehen upgraden angezeigt werden - sind nicht in der Datei. Die Ergebnisse sind nach Popularität geordnet, und die ausgeblendeten Websites kommen nach den offenen. Daher kann eine Datei kürzer als das Limit sein oder gar keine Zeilen haben; dann sind die Download-Schaltflächen inaktiv.

Der Hinweis an jeder Schaltfläche sagt, wie viele Zeilen die Datei haben wird, zum Beispiel 7 von 1.059 Zeilen: In Ihrem Tarif ausgeblendete Websites werden nicht heruntergeladen. Wenn die Seite nicht zeigt, wo die offenen Zeilen enden, steht dort Höchstens: Die Datei endet bei der ersten in Ihrem Tarif ausgeblendeten Website, und die kann früher kommen.

Ist die Datei kürzer als die Ergebnisse, sagt ihre letzte Zeile, warum:

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

Die erste Form bedeutet, dass das Zeilenlimit des Tarifs erreicht wurde, die zweite, dass die in Ihrem Tarif ausgeblendeten Websites weggelassen wurden. Die Zeile beginnt mit # und ist in der Sprache der Website geschrieben, von der Sie heruntergeladen haben; ihre Zahlen haben kein Tausendertrennzeichen. 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 sind Links auf der Ergebnisseite; die Adresse darin funktioniert zehn Minuten lang von der Netzwerkadresse aus, die 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, mit Kopfzeile: die Domain, dann eine Spalte pro Ausdruck. Mehrere auf einer Website gefundene Werte teilen sich eine Zelle, einer pro Zeile. Die letzte Zeile beginnt mit # und sagt, wie viele Extraktionspunkte der Durchlauf verbraucht hat; gehen die Punkte des Tages aus, sagt die Zeile davor, wo es weitergeht. Siehe Extraktion.