提出请求 |文档 |品牌预警 API | WhoisXML API

发出请求

API端点

POST https://brand-alert.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",
    "sinceDate": "2024-07-20",
    "mode": "purchase",
    "withTypos": false,
    "responseFormat": "json",
    "punycode": true,
    "includeSearchTerms": [
        "google",
        "blog"
    ],
    "excludeSearchTerms": [
        "analytics"
    ]
}

标头

X-身份验证-口令牌

可使用此标头或 apiKey 参数进行 API 调用查询。

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

输入参数

API密钥

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

包括搜索条款

必填。搜索词数组。所有这些都应该出现在域名中。最多 4 项。不区分大小写

排除搜索词

选填的。搜索词数组。所有这些都不应该出现在域名中。最多 4 项。不区分大小写。

自日期

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

允许的日期在 [今天减去 14 天 — 今天] 间隔内。

默认为前一天的日期。

请注意,昨天的结果通常在 UTC 上午 10 点至 12 点之间提供。

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

模式

选填

预览– 仅返回域名的数量。未扣除任何积分。

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

可接受的值:预览|购买

默认:预览

有错别字

选填。如果为true ,搜索词集将因其可能的拼写错误而丰富。例如,对于术语“google”,拼写错误可能是:“goigle”、“gokgle”、“golgle”、“gopgle”、“goglee”、“gooogle”等。

可接受的值: false |true

默认值:false

如包含拼写错误,1 次将花费300个DRS 积分

了解更多:拼写错误生成常见问题解答

punycode

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

可接受的值: false |true

默认值: true

响应格式

选填。响应输出格式。

可接受的值: json | XML

默认值: json

免费访问

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

使用限制和请求限制

每秒最大请求数为30 。如果超出限制,后续搜索请求将被拒绝,直到下一秒

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