# 下載結果

每個結果頁都有用來下載搜尋結果的按鈕：**URLs**、**CSV** 及 **CSV+片段**。登入後還有**網域集**按鈕，它會保存結果，而不是下載。各行的次序與結果頁上相同。

## 各按鈕下載的內容

| 按鈕 | 檔案 | 每行內容 |
| --- | --- | --- |
| URLs | `statichotjarcom.txt` | 符合條件的網頁的網址。 |
| CSV | `statichotjarcom.csv` | `url;rank` |
| CSV+片段 | `statichotjarcom-snippets.csv` | `url;rank;snippets` |
| 網域集 | - | 網域會保存為[網域集](https://hk.publicwww.com/docs/clusters/creating/)；提示訊息會說明有多少項結果被存入。 |

檔案名稱取自查詢，只保留拉丁字母、數字、`-` 及 `_`，其餘字元一律刪去：`"static.hotjar.com"` 會得到 `statichotjarcom.csv`。

## 格式

- UTF-8 編碼。CSV 及 CSV+片段的第一行是欄位名稱：`url;rank` 或 `url;rank;snippets`。URLs 檔案沒有這一行。
- 各欄以分號 `;` 分隔。含有分號、逗號、Tab 字元、雙引號或換行的儲存格會以雙引號括起，其中的引號會寫兩次。這是標準 CSV：在試算表或 CSV 程式庫中選擇分號作分隔符，即可直接讀取；即使同時選擇逗號或 Tab 作分隔符，儲存格亦不會被拆開。
- 排名是網站在熱門度排名中的位置。沒有排名的網站，該欄為空白。
- 同一網頁的所有程式碼片段放在同一個儲存格內，以 `...` 連接。
- 以 `=`、`+`、`-` 或 `@` 開頭的程式碼片段前面會加上一個撇號，讓試算表直接顯示它，而不會當作公式執行。電話號碼之類的數字則保持原樣。

## 行數

結果從最前面開始取，最多到方案的上限：URLs 及 CSV 為**每次搜尋結果數（含下載）**，CSV+片段為**含程式碼片段下載（項）**。具體數字見[價格](https://hk.publicwww.com/prices.html)頁面。未登入時，檔案只包含第一頁結果：最多 20 項。

您的方案中隱藏的網站，即顯示為**註冊即可查看**或**升級即可查看**的項目，不會包含在檔案內。結果按熱門度排列，隱藏的網站排在可打開的網站之後，因此檔案可能比上限短，甚至沒有任何項目；這時下載按鈕無法使用。

每個按鈕的提示會說明檔案將有多少項，例如*7 項（共 1,059 項）：您的方案中隱藏的網站不會下載*。如果從頁面看不出可打開的項目到哪裡為止，提示會寫*最多*。

如果檔案比結果短，最後一行會說明原因：

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

第一種表示已達到方案的項數上限，第二種表示您的方案中隱藏的網站已被略去。這一行以 `#` 開頭，使用您下載時所在網站的語言，當中的數字不帶千位分隔符。它不是結果：以程式讀取檔案時請略過它。如果沒有這一行，檔案就包含全部結果。

下載的消耗與搜尋本身相同：從每日配額扣除一次搜尋，CSV+片段另外扣除一次含程式碼片段下載——請參閱[配額與速率限制](https://hk.publicwww.com/docs/api/limits/)。當日的搜尋次數用完後，下載只包含免費方案允許的結果，最後一行會說明檔案已被截短。

## 在腳本中下載

按鈕是結果頁上的連結；從打開頁面的網絡位址存取時，連結中的網址十分鐘內有效。如要從您自己的程式碼下載，請使用 [API](https://hk.publicwww.com/docs/api/)：`/v1/search` 加上 `format=csv` 或 `format=txt`。帶 `?key=` 的[舊版匯出網址](https://hk.publicwww.com/docs/api/legacy/)完全保留原有格式：儲存格不加引號，沒有最後一行，沒有排名的網站顯示為 `>30M`。

## 其他下載

- **網域集**：在[網域集](https://hk.publicwww.com/profile/clusters/)列表中按下載圖示，會得到一個文字檔，每行一個網域。
- **提取**：CSV 以逗號而不是分號分隔，有標題行，先是網域，然後每個表達式一欄。在同一網站上找到的多個值放在同一個儲存格內，每行一個。最後一行以 `#` 開頭，說明這次執行用了多少提取點數；當日的點數用完時，倒數第二行會說明應從哪裏繼續。請參閱[提取](https://hk.publicwww.com/docs/clusters/extraction/)。

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