提出请求 | 文档 | 注册人预警 API | WhoisXML API

提出请求

API端点

POST https://registrant-alert.whoisxmlapi.com/api/v2
注册后将花费一分钟来激活账户。

请注意,搜索结果仅限于 10,000 条记录。如果您想获得更多相关结果,请尝试优化搜索查询或使用高级搜索。

Postman集合

Postman 是一款桌面和网络应用程序,通过图形用户界面向API发出请求。在探索 API 使用功能时,建议将 Postman与 WhoisXML API 端点结合使用、 以及排除应用程序故障时使用。

WhoisXML API Postman 系列可从以下链接获取:

该程序集包含一个预配置环境。用户需要设置 api_key变量,以便 启动每个搜索请求。请在 "我的产品"页面获取个人 API密钥。如有关于API的任何问题,请联系我们

POST 请求正文示例

{
    "apiKey": "API_KEY",
    "sinceDate": "2019-04-20",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms":
    {
        "include": [
            "Airbnb",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

用户可以在一个请求中提供多达四个包含和排除搜索条件。如果使用多个包含/排除搜索条件,输出结果将包括所有包含条件但不包含任何排除条件的域名。

输出结果包括注册人添加或删除的域名,这些域名在以下任一字段中都有术语:

注册人联系字段

RegistrantContact.City, RegistrantContact.Country, RegistrantContact.Email, RegistrantContact.Fax, RegistrantContact.FaxExtension, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.PostalCode, RegistrantContact.State, RegistrantContact.StreetAddress, RegistrantContact.Telephone, RegistrantContact.TelephoneExtension

抬头

X-Authentication-Token

用户可以在调用 API 时使用此抬头或 apiKey 参数。

"我的产品"页面获取用户的个人 API密钥。

输入参数

apiKey

必填。在 "我的产品"页面获取您的个人 API密钥。

basicSearchTerms.include

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

basicSearchTerms.exclude

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

sinceDate

选填。日期,格式为 "YYYY-MM-DD"。

所允许的日期间隔为 [今天减去 14 天 - 今天]。

默认日期为昨天。

注意,昨天的搜索结果通常在世界协调时上午 10-12 点之间公布。

如果存在,则搜索给定日期后发现的活动。有时,实际添加/续订/过期日期与我们的系统检测到此更改的日期之间会有延迟。建议在监控工具中使用此字段过滤每日变更。

mode

选填

预览- 仅返回域名数量。不扣除积分。

购买- 结果显示实际域名列表(限 10,000 个)。1 次申请花费10个 DRS积分。

可接受值:预览|购买

默认值:预览

punycode

选填。如果为 "正确",结果中的域名将编码为Punycode

可接受值:错误|正确

默认值:正确

responseFormat

选填。响应输出格式。

可接受值:json|xml

默认值:json

createdDateFrom

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索给定日期后创建的域名。

创建日期至

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索在给定日期之前创建的域名。

updatedDateFrom

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索给定日期后创建的域名。

updatedDateTo

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索给定日期前更新的域名。

expiredDateFrom

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索给定日期后到期的域名。

expiredDateTo

选填。日期,格式为 "YYYY-MM-DD"。

如果存在,则搜索在给定日期前到期的域名。

免费访问

注册后,用户将自动获得一个免费订阅计划,赠送最多500个DRS积分。

使用限制和请求节流

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

该 API 还提供专用负载平衡器和高级端点,以加快查询速度,为高级版 API 服务企业 API 套餐的一部分。

高级搜索 API 文档

高级搜索允许通过具体的 WHOIS 字段进行搜索。