下载结果
每个结果页都有用于下载搜索结果的按钮: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 文件没有这一行。 - 各列以分号
;分隔。含有分号、逗号、制表符、双引号或换行的单元格会用双引号括起来,其中的引号写两次。这是标准 CSV:在电子表格软件或 CSV 库中选择分号作为分隔符,即可直接读取;即使同时选择了逗号或制表符作为分隔符,单元格也不会被拆开。 - 排名是网站在热度排名中的位次。没有排名的网站该列为空。
- 同一页面的所有代码片段放在一个单元格中,以
...连接。 - 以
=、+、-或@开头的代码片段前面会加一个撇号,这样电子表格会直接显示它,而不会当作公式执行。电话号码之类的数字保持原样。
行数
行从结果的最前面开始取,最多到套餐的上限: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= 的旧版导出 URL 完全保留原来的格式:单元格不加引号,没有最后一行,没有排名的网站显示为 >30M。
其他下载
- 域名集:在域名集列表中点击下载图标,会得到一个文本文件,每行一个域名。
- 数据提取:CSV 以逗号而不是分号分隔,带表头行,先是域名,然后每个表达式一列。在同一网站上找到的多个值放在同一个单元格中,每行一个。最后一行以
#开头,说明本次运行消耗了多少提取点数;当天的点数用完时,倒数第二行会说明应从哪里继续。详见数据提取。