# 下载结果

每个结果页都有用于下载搜索结果的按钮：**URLs**、**CSV** 和 **CSV+代码片段**。登录后还有**域名集**按钮，它会保存结果，而不是下载。各行的顺序与结果页上相同。

## 各按钮下载的内容

| 按钮 | 文件 | 每行内容 |
| --- | --- | --- |
| URLs | `query.txt` | 匹配页面的地址。 |
| CSV | `query.csv` | `url;rank` |
| CSV+代码片段 | `query-snippets.csv` | `url;rank;snippets` |
| 域名集 | - | 域名保存为[域名集](https://zh.publicwww.com/docs/clusters/creating/)；提示信息会说明有多少条结果被保存进去。 |

文件名取自查询，只保留拉丁字母、数字、`-` 和 `_`，其余字符都去掉：`"static.hotjar.com"` 得到 `statichotjarcom.csv`。

## 格式

- UTF-8 编码，没有表头行。
- 各列以分号 `;` 分隔。含有分号、双引号或换行的单元格会用双引号括起来，其中的引号写两次。这是标准 CSV：在电子表格软件或 CSV 库中选择分号作为分隔符，即可直接读取。
- 排名是网站在热度排名中的位次。没有排名的网站该列为空。
- 同一页面的所有代码片段放在一个单元格中，以 `...` 连接。
- 以 `=`、`+`、`-` 或 `@` 开头的代码片段前面会加一个撇号，这样电子表格会直接显示它，而不会当作公式执行。电话号码之类的数字保持原样。

## 行数

文件包含您的套餐可见的结果，也就是在结果页上能打开的那些行，最多到套餐的上限：URLs 和 CSV 为**每次搜索结果数（含下载）**，CSV+代码片段为**带代码片段下载（行）**。具体数字见[价格](https://zh.publicwww.com/prices.html)页面。行从结果的最前面开始取。

如果套餐限制使结果被截断，文件最后一行会注明：

```
# Truncated at the plan limit: 1,000 of 22,694 results.
```

这一行以 `#` 开头，使用您下载时所在网站的语言。它不是结果：用程序读取文件时请跳过它。如果没有这一行，说明文件包含了全部结果。

下载的消耗与搜索本身相同：从每日配额中扣除一次搜索，CSV+代码片段还要扣除一次带代码片段下载，详见[配额与速率限制](https://zh.publicwww.com/docs/api/limits/)。当天的搜索次数用完后，下载只包含免费版允许的结果，最后一行会说明文件被截断。

## 在脚本中下载

按钮在页面内生成下载地址，该地址在打开页面的浏览器中十分钟内有效。要从您自己的代码下载，请使用 [API](https://zh.publicwww.com/docs/api/)：`/v1/search` 加上 `format=csv` 或 `format=txt`。带 `?key=` 的[旧版导出 URL](https://zh.publicwww.com/docs/api/legacy/) 完全保留原来的格式：单元格不加引号，没有最后一行，没有排名的网站显示为 `>30M`。

## 其他下载

- **域名集**：在[域名集](https://zh.publicwww.com/profile/clusters/)列表中点击下载图标，会得到一个文本文件，每行一个域名。
- **数据提取**：CSV 以逗号而不是分号分隔，带表头行，先是域名，然后每个表达式一列。在同一网站上找到的多个值放在同一个单元格中，每行一个。最后一行以 `#` 开头，说明本次运行消耗了多少提取点数；当天的点数用完时，倒数第二行会说明应从哪里继续。详见[数据提取](https://zh.publicwww.com/docs/clusters/extraction/)。

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