输出格式

域名信息和每周变更文件采用JSON Lines(.jsonl) 格式——每行一个 JSON 记录。域名文件是一个单列 CSV (.csv) 文件，包含一行名为 domainName 的标题行。所有数据源文件均使用 zstd (Zstandard) 进行压缩。

域名信息文件

数据内容包括：每个域名对应一条增强型域名注册记录。如果当前 WHOIS 或 RDAP 记录中的某个字段被遮盖或缺失，则使用历史 WHOIS 记录中可获取的最新值进行补全。
文件名格式： domain_info.%date%.weekly.jsonl.zst
示例： domain_info.sample.weekly.jsonl.zst

每个记录由域名、包含域名注册字段的数据部分以及五个联系人部分组成。每个字段都是一个对象，其中包含字段值、该值最后一次被我们的系统确认的日期，以及一个标志——该标志用于指示该值是否因当前有效记录中该字段为空或被屏蔽，而从历史记录中恢复而来。

{
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2013-07-22T00:00:00+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-03-22T20:15:53+00:00", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2013-07-22", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-03-22T20:15:53.197Z", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-05-26T14:47:11+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "John Doe", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "organization", "fieldValue": "Example Inc.", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "telephoneExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "fax", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true},
    {"fieldName": "faxExt", "fieldValue": "", "auditDate": "2023-03-24T02:14:35+00:00", "isEmptyOrRedactedNow": true}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [ ... ]
}

记录结构

域名	相关的域名。
数据	域名的注册记录字段（日期、域名服务器、注册商、状态）。一个由字段对象组成的数组（参见下文“字段对象结构”）。
注册人联系信息	包含注册人的联系信息。一个字段对象数组。
行政联系人	包含管理联系信息。其结构与registrantContact字段相同。
技术联系人	包含技术联系信息。其结构与registrantContact字段相同。
账单联系人	包含账单联系信息。其结构与registrantContact字段相同。
zoneContact	包含区域联系信息。其结构与registrantContact字段相同。

字段对象结构

“数据”和“联系人”部分中的每个字段都是一个包含以下键的对象：

fieldName	字段名称（参见下方的字段列表）。
fieldValue	该字段可用的最具信息量的值。若该字段在当前 WHOIS/RDAP 记录中已定义，则取自该记录；否则，从包含该值的最新历史 WHOIS 记录中恢复该值。如果从未捕获过该值，则返回空字符串或null。
审计日期	该字段的值最后一次被我们的系统确认或捕获的日期，采用 ISO 8601 格式。
isEmptyOrRedactedNow	如果当前有效记录中的该字段为空或已被屏蔽，则返回 true——这意味着显示的值是从历史 WHOIS 数据中恢复的。如果该值来自当前记录，则返回 false。

数据部分的字段

createdDateISO8601	域名的注册日期，采用 ISO 8601 格式。
更新日期ISO8601	域名注册记录的最后更新日期，采用 ISO 8601 格式。
到期日期（ISO 8601格式）	该域名的注册到期日期，采用 ISO 8601 格式。
createdDateRaw	该域名的 WHOIS 记录最初创建的日期，以原始格式显示。
updatedDateRaw	该域名的 WHOIS 记录最后一次更新的日期，以原始格式显示。
expiresDateRaw	该域名的 WHOIS 记录到期日期，以原始格式显示。
域名服务器	该域名的域名服务器，用“\|”分隔。
whoisServer	收集该记录的WHOIS服务器。
注册商名称	注册商名称
状态	域名状态代码。参见https://www.icann.org/resources/pages/epp-status-codes-2014-06-16-en

“联系人”部分的字段

所有五个联系人部分（registrantContact、administrativeContact、technicalContact、 billingContact、zoneContact）都使用相同的字段列表：

名称	联系人的姓名。
组织	该联系人的所属机构。
街道	联系人的街道地址。
城市	该联系人的城市。
状态	该联系人的所在州或地区。simplified-chinese (mainland)
邮政编码	该联系人的邮政编码。
国家	该联系人的国家。
电子邮件	该联系人的电子邮件地址。
电话	联系人的电话号码。
telephoneExt简体中文（大陆）	该联系人的电话分机号。
传真	该联系人的传真号码。
faxExt简体中文（大陆）	该联系人的传真分机号。

域名文件

数据内容包括：数据源所涵盖的域名完整列表，不包含其注册记录。
文件名格式： domain_names.%date%.weekly.csv.zst
文件名示例： domain_names.2026-07-13.weekly.csv.zst
示例： domain_names.sample.weekly.csv.zst
格式：单栏 CSV — 包含一行“domainName”标题行，随后每行一个域名。

域名
example.com
example.net
example.org
...

每周变更文件

数据包括：本周内新增或更新了记录的域名。
文件名格式： domain_info.%date%.weekly.diff.jsonl.zst
文件名示例： domain_info.2026-07-13.weekly.diff.jsonl.zst
示例： domain_info.sample.weekly.diff.jsonl.zst

每行都是一条记录，其结构与域名信息文件中的结构相同（包括数据部分和五个联系信息部分），前面带有两个键：changeType，用于说明该域名出现在文件中的原因；以及domainName。

{
  "changeType": "updated",
  "domainName": "example.com",
  "data": [
    {"fieldName": "createdDateISO8601", "fieldValue": "2024-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateISO8601", "fieldValue": "2025-09-26T07:58:15+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateISO8601", "fieldValue": "2026-08-19T18:26:12+00:00", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "createdDateRaw", "fieldValue": "2024-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "updatedDateRaw", "fieldValue": "2025-09-26T07:58:15Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "expiresDateRaw", "fieldValue": "2026-08-19T18:26:12Z", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "nameServers", "fieldValue": "ns1.example.com|ns2.example.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "whoisServer", "fieldValue": "whois.example-registrar.com", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "registrarName", "fieldValue": "Example Registrar, Inc.", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "status", "fieldValue": "clientTransferProhibited", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false}
  ],
  "registrantContact": [
    {"fieldName": "name", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "organization", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "street", "fieldValue": "123 Example Street", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "city", "fieldValue": "Jacksonville", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "state", "fieldValue": "FL", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "postalCode", "fieldValue": "32256", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "country", "fieldValue": "UNITED STATES", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "email", "fieldValue": "[email protected]", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephone", "fieldValue": "13105551234", "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "telephoneExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "fax", "fieldValue": "13105555678", "auditDate": "2024-07-02T21:01:51+00:00", "isEmptyOrRedactedNow": false},
    {"fieldName": "faxExt", "fieldValue": "Statutory Masking Enabled", "auditDate": "2025-08-20T00:00:00+00:00", "isEmptyOrRedactedNow": false}
  ],
  "administrativeContact": [ ... ],
  "technicalContact": [ ... ],
  "billingContact": [ ... ],
  "zoneContact": [
    {"fieldName": "name", "fieldValue": null, "auditDate": "2025-09-29T21:39:51+00:00", "isEmptyOrRedactedNow": true},
    ...
  ]
}

输出字段说明

changeType	该域名为何会出现在本周的变更文件中。原因可能是以下之一：补充说明——该域名是在本周首次被发现的。更新——该域名在本周之前就已经被知晓，且其记录在本周内发生了变更。
域名	相关的域名。
data, registrantContact, administrativeContact, technicalContact, billingContact, zoneContact	与域信息文件中的情况相同——请参阅上文的“记录结构”和“字段对象结构”。如果某个字段在当前活动记录中不存在且没有历史值，则该字段的 fieldValue 为 null，且isEmptyOrRedactedNow设置为true。

WHOIS/WHOIS历史信息

DNS/DNS历史信息

IP地理定位/IP网块

域名查询服务（DRS）

域名/WHOIS

DNS/IP

情报

其他

域名/WHOIS

DNS/IP

情报

其他

域名/WHOIS

DNS/IP

情报

其他

域名查询服务（DRS）

新通用顶级域名情报服务（NGIS）

研究

监测

白标

预测性威胁情报源

互联网基础设施

企业API套餐

安全情报信息（SI）套餐

攻击面发现 API

MCP 服务器

Jake AI

WhoisXML API域名情报顾问（通过 ChatGPT）

输出格式

域名信息文件

记录结构

字段对象结构

数据部分的字段

“联系人”部分的字段

域名文件

每周变更文件

输出字段说明

问题咨询