# 結果のダウンロード

どの検索結果ページにも、検索で見つかったものをダウンロードするボタンがあります。**URLs**、**CSV**、**CSV+スニペット**です。ログインしている場合は**クラスター**ボタンもあり、こちらは結果をダウンロードせずに保存します。行の並びは結果ページと同じです。

## 各ボタンで得られるもの

| ボタン | ファイル | 各行 |
| --- | --- | --- |
| URLs | `query.txt` | 一致したページのアドレス。 |
| CSV | `query.csv` | `url;rank` |
| CSV+スニペット | `query-snippets.csv` | `url;rank;snippets` |
| クラスター | - | ドメインが[クラスター](https://ja.publicwww.com/docs/clusters/creating/)として保存されます。結果のうち何件が入ったかはメッセージに表示されます。 |

ファイル名はクエリから、ラテン文字、数字、`-`、`_`以外をすべて取り除いたものになります。たとえば`"static.hotjar.com"`なら`statichotjarcom.csv`です。

## 形式

- UTF-8で、ヘッダー行はありません。
- 列はセミコロン`;`で区切られます。セミコロン、二重引用符、改行を含むセルは二重引用符で囲まれ、中の引用符は2つ重ねられます。これは標準的なCSVです。区切り文字にセミコロンを選べば、スプレッドシートやCSVライブラリでそのまま読み込めます。
- 順位は、人気順位でのサイトの位置です。順位のないサイトでは空欄になります。
- 1ページのスニペットはすべて1つのセルに入り、`...`でつながれます。
- `=`、`+`、`-`、`@`で始まるスニペットには先頭にアポストロフィが付きます。スプレッドシートがそれを数式として実行せず、そのまま表示するためです。電話番号などの数字はそのままです。

## 行数

ファイルには、プランで表示される範囲の結果（結果ページで開ける行）が、プランの上限まで入ります。上限は、URLsとCSVでは**1回の検索の結果数（ダウンロードも同じ）**、CSV+スニペットでは**スニペット付きダウンロード（行）**です。数値は[料金](https://ja.publicwww.com/prices.html)ページにあります。行は結果の上から順に取られます。

プランの上限で結果が途中までになった場合は、ファイルの最後の行にその旨が書かれます。

```
# Truncated at the plan limit: 1,000 of 22,694 results.
```

この行は`#`で始まり、ダウンロードしたサイトの言語で書かれます。結果ではないため、プログラムでファイルを読み込むときは読み飛ばしてください。この行がなければ、ファイルにはすべての結果が入っています。

ダウンロードは、検索そのものと同じように利用枠を消費します。1日の利用枠から検索1回分、CSV+スニペットではさらにスニペット付きダウンロード1回分です。詳しくは[利用枠とレート制限](https://ja.publicwww.com/docs/api/limits/)をご覧ください。その日の検索回数を使い切ると、ダウンロードには無料プランで許される分だけが入り、最後の行にファイルが途中で切られたことが書かれます。

## スクリプトから

ボタンはページ内でダウンロード用のアドレスを作ります。このアドレスは、ページを開いたブラウザで10分間有効です。自分のコードからダウンロードするには、[API](https://ja.publicwww.com/docs/api/)の`/v1/search`を`format=csv`または`format=txt`で使ってください。`?key=`を付けた[旧エクスポートURL](https://ja.publicwww.com/docs/api/legacy/)は、以前の形式をそのまま保っています。セルは引用符で囲まれず、最後の行もなく、順位のないサイトには`>30M`と表示されます。

## その他のダウンロード

- **クラスター** - [クラスター](https://ja.publicwww.com/profile/clusters/)の一覧にあるダウンロードアイコンから、そのドメインを1行に1つずつ並べたテキストファイルを取得できます。
- **抽出** - セミコロンではなくカンマで区切ったCSVです。ドメインの後に、式ごとに1列が続きます。1つのサイトで複数の値が見つかった場合は、1行に1つずつ同じセルに入ります。その日のポイントがなくなると、最後の行にどこから続ければよいかが書かれます。詳しくは[抽出](https://ja.publicwww.com/docs/clusters/extraction/)をご覧ください。

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