下載結果
每個結果頁都有用來下載搜尋結果的按鈕: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 檔案沒有這一行。 - 各欄以分號
;分隔。含有分號、逗號、Tab 字元、雙引號或換行的儲存格會以雙引號括起,其中的引號會寫兩次。這是標準 CSV:在試算表或 CSV 程式庫中選擇分號作分隔符,即可直接讀取;即使同時選擇逗號或 Tab 作分隔符,儲存格亦不會被拆開。 - 排名是網站在熱門度排名中的位置。沒有排名的網站,該欄為空白。
- 同一網頁的所有程式碼片段放在同一個儲存格內,以
...連接。 - 以
=、+、-或@開頭的程式碼片段前面會加上一個撇號,讓試算表直接顯示它,而不會當作公式執行。電話號碼之類的數字則保持原樣。
行數
結果從最前面開始取,最多到方案的上限:URLs 及 CSV 為每次搜尋結果數(含下載),CSV+片段為含程式碼片段下載(項)。具體數字見價格頁面。未登入時,檔案只包含第一頁結果:最多 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+片段另外扣除一次含程式碼片段下載——請參閱配額與速率限制。當日的搜尋次數用完後,下載只包含免費方案允許的結果,最後一行會說明檔案已被截短。
在腳本中下載
按鈕是結果頁上的連結;從打開頁面的網絡位址存取時,連結中的網址十分鐘內有效。如要從您自己的程式碼下載,請使用 API:/v1/search 加上 format=csv 或 format=txt。帶 ?key= 的舊版匯出網址完全保留原有格式:儲存格不加引號,沒有最後一行,沒有排名的網站顯示為 >30M。
其他下載
- 網域集:在網域集列表中按下載圖示,會得到一個文字檔,每行一個網域。
- 提取:CSV 以逗號而不是分號分隔,有標題行,先是網域,然後每個表達式一欄。在同一網站上找到的多個值放在同一個儲存格內,每行一個。最後一行以
#開頭,說明這次執行用了多少提取點數;當日的點數用完時,倒數第二行會說明應從哪裏繼續。請參閱提取。