結果のダウンロード
どの検索結果ページにも、検索で見つかったものをダウンロードするボタンがあります。URLs、CSV、CSV+スニペットです。ログインしている場合はクラスターボタンもあり、こちらは結果をダウンロードせずに保存します。行の並びは結果ページと同じです。
各ボタンで得られるもの
| ボタン | ファイル | 各行 |
|---|---|---|
| URLs | statichotjarcom.txt | 一致したページのアドレス。 |
| CSV | statichotjarcom.csv | url;rank |
| CSV+スニペット | statichotjarcom-snippets.csv | url;rank;snippets |
| クラスター | - | ドメインがクラスターとして保存されます。結果のうち何件が入ったかはメッセージに表示されます。 |
ファイル名はクエリから、ラテン文字、数字、-、_以外をすべて取り除いたものになります。たとえば"static.hotjar.com"ならstatichotjarcom.csvです。
形式
- UTF-8です。CSVとCSV+スニペットでは、最初の行に列名が入ります（
url;rankまたはurl;rank;snippets）。URLsのファイルにはこの行はありません。 - 列はセミコロン
;で区切られます。セミコロン、カンマ、タブ、二重引用符、改行を含むセルは二重引用符で囲まれ、中の引用符は2つ重ねられます。これは標準的なCSVです。区切り文字にセミコロンを選べば、スプレッドシートやCSVライブラリでそのまま読み込めます。カンマやタブも区切り文字に選んだ場合でも、セルは分割されません。 - 順位は、人気順位でのサイトの位置です。順位のないサイトでは空欄になります。
- 1ページのスニペットはすべて1つのセルに入り、
...でつながれます。 =、+、-、@で始まるスニペットには先頭にアポストロフィが付きます。スプレッドシートがそれを数式として実行せず、そのまま表示するためです。電話番号などの数字はそのままです。
行数
行は結果の上から順に、プランの上限まで取られます。上限は、URLsとCSVでは1回の検索の結果数（ダウンロードも同じ）、CSV+スニペットではスニペット付きダウンロード（行）です。数値は料金ページにあります。ログインしていない場合、ファイルに入るのは結果の最初のページ（最大20行）です。
ご利用のプランで非表示のサイト（登録して表示またはアップグレードして表示と表示される行）はファイルに入りません。結果は人気順に並び、非表示のサイトは開けるサイトの後に来るため、ファイルが上限より短くなったり、1行も入らなかったりすることがあります。その場合、ダウンロードボタンは無効になります。
各ボタンのヒントには、ファイルに入る行数が表示されます。たとえば1,059行中7行：ご利用のプランで非表示のサイトはダウンロードされませんのように表示されます。開ける行がどこまでかがページからわからない場合は、最大と表示されます。ファイルはご利用のプランで非表示の最初のサイトで終わり、それはもっと前に現れることもあります。
ファイルが結果より短い場合は、最後の行にその理由が書かれます。
# Truncated at the plan limit: 1000 of 22694 results. # 7 of 1059 results: websites hidden on your plan are left out.
1つ目の形はプランの行数の上限に達したこと、2つ目はご利用のプランで非表示のサイトが除かれたことを示します。この行は#で始まり、ダウンロードしたサイトの言語で書かれ（上の例は英語版のものです）、数字に桁区切りは付きません。結果ではないため、プログラムでファイルを読み込むときは読み飛ばしてください。この行がなければ、ファイルにはすべての結果が入っています。
ダウンロードは、検索そのものと同じように利用枠を消費します。1日の利用枠から検索1回分、CSV+スニペットではさらにスニペット付きダウンロード1回分です。詳しくは利用枠とレート制限をご覧ください。その日の検索回数を使い切ると、ダウンロードには無料プランで許される分だけが入り、最後の行にファイルが途中で切られたことが書かれます。
スクリプトから
ボタンは結果ページ上のリンクです。リンクのアドレスは、ページを開いたネットワークアドレスから10分間有効です。自分のコードからダウンロードするには、APIの/v1/searchをformat=csvまたはformat=txtで使ってください。?key=を付けた旧エクスポートURLは、以前の形式をそのまま保っています。セルは引用符で囲まれず、最後の行もなく、順位のないサイトには>30Mと表示されます。
その他のダウンロード
- クラスター - クラスターの一覧にあるダウンロードアイコンから、そのドメインを1行に1つずつ並べたテキストファイルを取得できます。
- 抽出 - セミコロンではなくカンマで区切ったCSVで、ヘッダー行があります。ドメインの後に、式ごとに1列が続きます。1つのサイトで複数の値が見つかった場合は、1行に1つずつ同じセルに入ります。
#で始まる最後の行には、その実行で使った抽出ポイントの数が書かれます。その日のポイントがなくなった場合は、その前の行にどこから続ければよいかが書かれます。詳しくは抽出をご覧ください。