批量 Whois API 用户指南(旧)|文档 |批量 WHOIS API | WhoisXML API

批量 Whois API 用户指南(旧)

批量 Whois API 可通过单个 REST API 查询为域名/IP 列表提供 Whois 记录,主要在用户系统和 WhoisXMLAPI.com网络之间利用标准 HTTP或HTTPs 协议进行服务器到服务器通信。通过 POST 方法所发出的请求,查询响应结果以 XML 或 JSON 格式提供。

首先,需要注册 WhoisXmlApi.com 帐户。每次使用 API 时都需要进行身份验证。注册帐户,可免费获赠 500 次批量WHOIS API 调用。

调用查询批量 Whois API网络服务

地址 https://www.whoisxmlapi.com/BulkWhoisLookup/bulkServices/bulkWhois

在请求正文中提供 JSON 编码的参数,将 Content-Type 标头设置为 application/json。服务器响应将包含您需要检索请求的 WHOIS 记录的 requestId 字段。

JSON 响应示例

{
  "domains": [
    "google.com",
    "yahoo.com"
  ],
  "username": "your_username",
  "password": "********",
  "outputFormat": "JSON"
}

输入参数

域名

必填。请求 WHOIS 数据的一组域名

用户名

必填。帐户用户名

密码

必填。帐户密码。

如果包含特殊字符(&、%、* 等),确认是以URL 编码

输出格式

响应输出格式。

可接受的值: JSON | XML

默认值: XML

输出示例

{
  "noDataAvailable": false,
  "message": "OK",
  "messageCode": 200,
  "requestId": "ece0f949-c22a-4ecc-..."
}

获取 Whois 记录

地址 https://www.whoisxmlapi.com/BulkWhoisLookup/bulkServices/getRecords

由于处理所有输入域名可能需要一些时间,需重复查询此资源,直到返回的recordsLeft字段值为0

如果不需要查看每条记录的进度,请将maxRecords输入参数设置为1

否则, whoisRecords数组的每个元素都包含whoisRecordStatus字段:

  • 0 - 已处理;
  • 1/2 - 不完整/缺失数据;
  • 3 - 处理。

JSON 请求示例

{
  "requestId": "ece0f949-c22a-4ecc-...",
  "maxRecords": 1,
  "username": "your_username",
  "password": "********",
  "startIndex": 1,
  "outputFormat": "JSON"
}

输入参数

用户名

必填。帐户用户名

密码

必填。帐户密码。

如果包含特殊字符(&、%、* 等),确认是以URL 编码

请求ID

必填。字符。

批量请求标识符。

最大记录数

必填。数字。

要返回的 WHOIS 记录的最大数量。

起始索引

选填。数字。

服务器返回的第一个 WHOIS 记录。

可接受的值: 1+

默认值: 1

输出格式

选填。响应输出格式。

可接受的值: JSON | XML

默认值: XML

结果 CSV格式下载

地址 https://www.whoisxmlapi.com/BulkWhoisLookup/bulkServices/download

JSON 请求示例

{
  "requestId": "ece0f949-c22a-4ecc-...",
  "username": "your_username",
  "password": "********",
  "searchType": "all"
}

输入参数

用户名

必填。帐户用户名

密码

必填。帐户密码。

如果包含特殊字符(&、%、* 等),确认是以URL 编码

请求ID

必填。字符。

批量请求标识符。

搜索类型

选填。String。

noError允许过滤掉有处理错误、没有数据等的记录。

可接受的值:全部|没有错误

默认值:全部

检索搜索请求列表

地址 https://www.whoisxmlapi.com/BulkWhoisLookup/bulkServices/getUserRequests

JSON 请求示例

{
  "noDataAvailable": false,
  "userRequests": [
    {
      "requestId": "f1008d3e-7774-495b-...",
      "time": 1498282373092,
      "status": "Completed",
      "totalRecords": 4,
      "fetchedRecords": 0
    }
  ]
}

输入参数

用户名

必填。帐户用户名

密码

必填。帐户密码。

如果包含特殊字符(&、%、* 等),确认是以URL 编码

输出格式

选填。响应输出格式。

可接受的值: JSON | XML

默认值: XML

免费访问

注册后,将自动获得最高为 500个积分的免费订阅计划。