# 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](https://de.publicwww.com/docs/clusters/creating/) 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](https://de.publicwww.com/prices.html). 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](https://de.publicwww.com/docs/api/limits/). 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](https://de.publicwww.com/docs/api/): `/v1/search` mit `format=csv` oder `format=txt`. Die [alten Export-URLs](https://de.publicwww.com/docs/api/legacy/) 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](https://de.publicwww.com/profile/clusters/) 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](https://de.publicwww.com/docs/clusters/extraction/).

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