下载结果
每个结果页都有用于下载搜索结果的按钮:URLs、CSV 和 CSV+代码片段。登录后还有域名集按钮,它会保存结果,而不是下载。各行的顺序与结果页上相同。
各按钮下载的内容
| 按钮 | 文件 | 每行内容 |
|---|---|---|
| URLs | query.txt | 匹配页面的地址。 |
| CSV | query.csv | url;rank |
| CSV+代码片段 | query-snippets.csv | url;rank;snippets |
| 域名集 | - | 域名保存为域名集;提示信息会说明有多少条结果被保存进去。 |
文件名取自查询,只保留拉丁字母、数字、- 和 _,其余字符都去掉:"static.hotjar.com" 得到 statichotjarcom.csv。
格式
- UTF-8 编码,没有表头行。
- 各列以分号
;分隔。含有分号、双引号或换行的单元格会用双引号括起来,其中的引号写两次。这是标准 CSV:在电子表格软件或 CSV 库中选择分号作为分隔符,即可直接读取。 - 排名是网站在热度排名中的位次。没有排名的网站该列为空。
- 同一页面的所有代码片段放在一个单元格中,以
...连接。 - 以
=、+、-或@开头的代码片段前面会加一个撇号,这样电子表格会直接显示它,而不会当作公式执行。电话号码之类的数字保持原样。
行数
文件包含您的套餐可见的结果,也就是在结果页上能打开的那些行,最多到套餐的上限:URLs 和 CSV 为每次搜索结果数(含下载),CSV+代码片段为带代码片段下载(行)。具体数字见价格页面。行从结果的最前面开始取。
如果套餐限制使结果被截断,文件最后一行会注明:
# Truncated at the plan limit: 1,000 of 22,694 results.
这一行以 # 开头,使用您下载时所在网站的语言。它不是结果:用程序读取文件时请跳过它。如果没有这一行,说明文件包含了全部结果。
下载的消耗与搜索本身相同:从每日配额中扣除一次搜索,CSV+代码片段还要扣除一次带代码片段下载,详见配额与速率限制。当天的搜索次数用完后,下载只包含免费版允许的结果,最后一行会说明文件被截断。
在脚本中下载
按钮在页面内生成下载地址,该地址在打开页面的浏览器中十分钟内有效。要从您自己的代码下载,请使用 API:/v1/search 加上 format=csv 或 format=txt。带 ?key= 的旧版导出 URL 完全保留原来的格式:单元格不加引号,没有最后一行,没有排名的网站显示为 >30M。
其他下载
- 域名集:在域名集列表中点击下载图标,会得到一个文本文件,每行一个域名。
- 数据提取:CSV 以逗号而不是分号分隔,带表头行,先是域名,然后每个表达式一列。在同一网站上找到的多个值放在同一个单元格中,每行一个。最后一行以
#开头,说明本次运行消耗了多少提取点数;当天的点数用完时,倒数第二行会说明应从哪里继续。详见数据提取。