高级 API文件 | 文档 | 注册人预警 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",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES"
    }]
}

基本搜索所需的配置较少,搜索结果也较广泛。高级搜索允许通过特定 WHOIS 字段进行搜索。

在一个搜索请求中,您最多可以提供四个搜索条件。如果有多个搜索条件,输出结果将包括与所有条件匹配的域名。

搜索词包括域名 WHOIS 记录中的一个精确字段,即以下内容之一:

常见字段

电子邮箱

电子邮件字段可在一次查询中搜索 注册人联系方式电子邮件, 管理联系人电子邮件, 账单联系人电子邮件, 技术联系人电子邮件。

注册人联系字段

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

管理员联系方式字段

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

账单联系人字段

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

技术联系字段

TechContact.City、
TechContact.Country、
TechContact.Email、
TechContact.Fax、
TechContact.FaxExtension、
TechContact.Name、
TechContact.Organization、
TechContact.PostalCode、
TechContact.State、
TechContact.StreetAddress、
TechContact.Telephone、
TechContact.TelephoneExtension

抬头

X-Authentication-Token

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

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

输入参数进行高级搜索

对于高级搜索,请使用格式如下的advancedSearchTerms字块,而非basicSearchTerms字块:

advancedSearchTerms.field

必填。所需搜索的 WHOIS 字段。

advancedSearchTerms.term

必填。搜索字符串。不区分大小写。 

advancedSearchTerms.exactMatch

选填。布尔值。字段是否应完全匹配搜索词。 如果为false,则允许字段包含搜索词的子串。

可接受值:错误|正确

默认值:错误

请注意,目前该参数仅支持以下字段: RegistrantContact.NameRegistrantContact.OrganizationRegistrantContact.StreetAddressAdminContact.Name、 AdminContact.OrganizationAdminContact.StreetAddresBillingContact.Name、 BillingContact.Name, BillingContact.OrganizationBillingContact.StreetAddress、 TechContact.Name、 TechContact.OrganizationTechContact.Street

对于所有其他字段,它将被忽略并解释为"正确"。