高级 API 文档 |文档 |反向WHOIS API | WhoisXML API

发出请求

API端点

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

请注意,搜索结果限制为 10,000 条记录。如需获得关联度更高的结果,请尝试优化搜索查询或使用高级搜索。

Postman集合

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

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

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

POST 请求正文示例

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES",
        "exclude": true
    }]
}

基本搜索需要的配置较少但是会得到更广泛的搜索结果。高级搜索允许搜索特定的 WHOIS 字段。

用户可以在一个搜索请求中最多提供四个搜索词。对于多个搜索词,搜索结果包括与所有搜索词匹配的域名。

搜索词包含域名WHOIS 记录的确切字段,以下之一:

公共字段

DomainName,
NameServers,
WhoisServer,
Status,
RegistrarName,
Email

电子邮件字段允许在一次查询中搜索RegistrantContact.EmailAdminContact.EmailBillingContact.EmailTechContact.Email

注册人联系字段

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

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

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

输入高级搜索参数

对于高级搜索,请使用以下格式的advanceSearchTerms块,而非basicSearchTerms块:

advancedSearchTerms.field

必填。在哪个 WHOIS 字段中进行搜索。

advancedSearchTerms.term

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

advancedSearchTerms.exclude

选填。布尔值。如果该术语不应成为搜索的一部分,则将其排除。

可接受的值:错误|正确

默认值:错误

advancedSearchTerms.exactMatch

选填。布尔值。该字段是否应与搜索词完全匹配。如果为错误 ,则允许该字段包含搜索词作为子字符串。

可接受的值:错误|正确

默认值:错误

请注意,目前仅以下字段支持该参数: NameServersStatusRegistrantContact.NameRegistrantContact.OrganizationRegistrantContact.StreetAddressAdminContact.NameAdminContact.OrganizationAdminContact.StreetAddressBillingContact.NameBillingContact.OrganizationBillingContact.StreetAddressTechContact.NameTechContact.OrganizationTechContact.Street

对于所有其他字段,将会忽略并解析为正确 。

相反,可使用尾随通配符搜索来查找部分匹配项。

通配符搜索

请注意,通配符请求访问的数量限制为每分钟 5 个。

您可以使用通配符来搜索特定字段。请注意,除“domainName”之外的所有字段不能同时使用前导通配符和尾随通配符。在这种情况下,尾随的通配符将被删除。对于“domainName”字段,如果尾随通配符和前导通配符都存在,则不能使用中间通配符。在这种情况下,中间的通配符将被删除。注意,此类查询速度可能会很慢。

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Air*bnb*"
    }]
}

使用通配符的示例

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook."
    }]
}

- 返回 0 个域名

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook.*"
    }]
}

- 返回超过 400 个域名