发出请求 |文档 |反向 WHOIS API | WhoisXML API

发出请求

API端点

POST https://reverse-whois.whoisxmlapi.com/api/v2
注册后请激活您的帐户。

Postman集合

Postman 是一个桌面和 Web 应用程序,允许用户从图形用户界面向 API 发出请求。在探索 API 功能以及解决应用程序问题时,我们建议将 Postman 与 WhoisXML API 端点结合使用

WhoisXML API Postman 集合可从以下链接获得:

该集合包括一个预配置的环境。用户需要设置api_key变量来触发每个请求。在“我的产品”页面获取个人 API KEY 。如果您对 API 有任何疑问,请联系我们

POST 请求正文示例

{
    "apiKey": "YOUR_API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms": {
        "include": [
            "Airbnb, Inc.",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

在一次搜索请求中最多提供四个包含和排除的搜索词。对于有多个的搜索词,查询结果包括具有所有包含词但没有任何排除词的域名。

搜索结果包括在任意WHOIS 字段中包含搜索词的域名。

标题

X-Authentication-Token

您可以将此标题或 apiKey 参数用于 API 调用查询。

我的产品页面获取个人 API KEY。

输入参数

apiKey

必填。在“我的产品”页面获取个人 API KEY。

basicSearchTerms.include

必填。搜索字符串数组。所有信息都应该出现在域名的 WHOIS 详细信息中。最多 4 项。不区分大小写。

basicSearchTerms.exclude

选填。搜索字符串数组。所有信息都不应出现在域名的 WHOIS 详细信息中。最多 4 项。不区分大小写。

searchType

选填。搜索类型。

当前– 仅在当前 WHOIS 记录中搜索。

历史– 搜索实际和历史 WHOIS 记录。

可接受的值:当前的|历史的

默认值:当前

mode

选填

预览 – 只返回域名数量。不扣除积分。

购买 – 返回实际的域名列表(上限为 10,000)。 1 次查询请求花费 1 个 DRS 积分。

可接受的值:预览|购买

默认:预览

punycode

选填。如果为正确,响应中的域名将被编码为Punycode

可接受的值:错误|正确

默认值:正确

includeAuditDates

选填。如果为正确 ,输出的每个域名都将补充相应的审核日期。注意:该参数更改输出:域名数组(如果为错误 )-> 包含域名和审核日期的对象数组(如果为正确 )。

点击此处阅读有关 API 输出的更多信息。

可接受的值:错误|正确

默认值:错误

responseFormat

选填。响应输出格式。

可接受的值: json | XML

默认值: json

createdDateFrom

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期之后创建的域名。

createdDateTo

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期之前创建的域名。

updatedDateFrom

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期之后创建的域名。

updatedDateTo

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期之前更新的域名。

expiredDateFrom

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期后过期的域名。

expiredDateTo

选填。 “YYYY-MM-DD”格式的日期。

如有,搜索给定日期之前过期的域名。

searchAfter

选填。由于每个搜索结果限制为 10,000 条记录,因此您可以使用此参数检索下一页。该值应取自nextPageSearchAfter输出字段。结果中的所有域名均按其在数据库中出现的日期降序排列。

免费访问

注册后,您将自动获得一个免费订阅计划,可获取最高500 个 DRS免费积分。

使用限制和请求限制

每秒最大请求数为30 。如超过限制,您的后续请求将被拒绝,直到下一秒

此 API 也可与专用负载平衡器和高级端点一起使用,作为我们的高级版 API 服务企业 API 套餐的一部分实现更快更便捷的查询。