# 結果のダウンロード

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

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

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

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

## 形式

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

## 行数

行は結果の上から順に、プランの上限まで取られます。上限は、URLsとCSVでは**1回の検索の結果数（ダウンロードも同じ）**、CSV+スニペットでは**スニペット付きダウンロード（行）**です。数値は[料金](https://ja.publicwww.com/prices.html)ページにあります。ログインしていない場合、ファイルに入るのは結果の最初のページ（最大20行）です。

ご利用のプランで非表示のサイト（**登録して表示**または**アップグレードして表示**と表示される行）はファイルに入りません。結果は人気順に並び、非表示のサイトは開けるサイトの後に来るため、ファイルが上限より短くなったり、1行も入らなかったりすることがあります。その場合、ダウンロードボタンは無効になります。

各ボタンのヒントには、ファイルに入る行数が表示されます。たとえば*1,059行中7行：ご利用のプランで非表示のサイトはダウンロードされません*のように表示されます。開ける行がどこまでかがページからわからない場合は、*最大*と表示されます。ファイルはご利用のプランで非表示の最初のサイトで終わり、それはもっと前に現れることもあります。

ダウンロードは、検索そのものと同じように利用枠を消費します。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で、ヘッダー行があります。詳しくは[抽出](https://ja.publicwww.com/docs/clusters/extraction/)をご覧ください。

Source: https://ja.publicwww.com/docs/search/downloads/
