过期域名 Webhook — Zapier、Make、n8n、IFTTT

面向过期域名的 Webhook

域名命中筛选或价格变动时发送 POST 的 Expired Domains Webhook

使用与 Public API 相同的 Pro 密钥订阅。筛选命中、拍卖变化，或你更新备注、收藏、用户任务时，Karma.Domains 会把签名 JSON 事件发到 Zapier、Make、n8n、IFTTT 或任意公开 HTTPS URL。

30 个订阅

5,000 次投递/天

3 种订阅

60/min 共享速率限制

连接 Zapier、Make、n8n 或 IFTTT

在你的工具里创建 webhook 触发器，复制它的 HTTPS URL，再用 POST /v1/webhooks 登记。同一次调用适用于每个客户端 — 变的只是 URL。

订阅	每账户 30 个
投递	每个 UTC 日 5,000 次
速率限制	每密钥每分钟 60 次请求（与 Public API 和 MCP 共享）

Zapier — Webhooks by Zapier，Catch Hook

创建一个 Zap，触发器选 Webhooks by Zapier，再选 Catch Hook。
复制 Zapier 显示的 HTTPS webhook URL。
用 Pro 密钥、该 URL、kind 和你要的事件发送 POST /v1/webhooks。第一次投递后测试这个 Zap。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

Make — Webhooks 模块，Custom webhook

添加 Webhooks 模块并选择 Custom webhook。创建 webhook 并复制 URL。
用 Pro 密钥和该 URL 发送 POST /v1/webhooks。
把场景运行一次，让 Make 看到 payload，再映射你需要的字段。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://hook.eu1.make.com/your-webhook-id",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

n8n — Webhook 节点

添加 Webhook 节点，HTTP 方法设为 POST，并复制 production URL。
用 Pro 密钥和该 URL 发送 POST /v1/webhooks。
激活工作流。该节点每次投递收到一条 JSON 事件。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://n8n.example.com/webhook/karma-domains",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

IFTTT — Webhooks 服务

连接 Webhooks 服务，复制你要的事件名对应的 URL。
用 Pro 密钥和该 URL 发送 POST /v1/webhooks。
在 applet 动作里使用 JSON 正文。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://maker.ifttt.com/trigger/karma_domains/with/key/YOUR_IFTTT_KEY",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

任意公开 HTTPS 端点

搭一个对 JSON POST 返回 2xx 的 HTTPS 端点。
用 Pro 密钥和该 URL 发送 POST /v1/webhooks。
用创建响应里的 whsec_ 密钥校验签名，再处理事件类型。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://example.com/hooks/karma",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

三种订阅方式

一条事件对应一份报告；用户任务事件除外，那是每个任务一条。密钥只在创建订阅或轮换时返回。

筛选命中

kind=filter 在报告开始匹配与 POST /v1/reports/search 相同的筛选时发送 domain.matched_filter。游标从订阅时开始，旧行不会重放。报告离开筛选后再次命中，可以再次触发。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "filter",
    "url": "https://hooks.example.com/karma",
    "events": ["domain.matched_filter"],
    "bases": ["expired", "auctions"],
    "filter": { "karmascore_min": 60 }
  }'

你收到的事件

{
  "id": "evt_example",
  "type": "domain.matched_filter",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "domain": "example.com",
    "report_id": "665f0example",
    "report_type": "expired"
  },
  "data": { "current": { "changed_at": 1710000000 } },
  "links": { "report": "https://karma.domains/app/reports/expired/report-665f0example/" }
}

指定报告

kind=reports 最多关注 100 份报告。拍卖事件覆盖价格、出价次数、即将结束和已结束。备注、标签和收藏事件只发给做出更改的账户 — 另一个账户为了价格关注同一份报告时收不到。只有选择 auction.ending_soon 时才需要 ending_soon_seconds。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "reports",
    "url": "https://hooks.example.com/karma",
    "events": ["auction.price_changed", "report.note_changed"],
    "reports": [{ "report_type": "auctions", "report_id": "665f0example" }]
  }'

你收到的事件

{
  "id": "evt_example",
  "type": "auction.price_changed",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "domain": "example.com",
    "report_id": "665f0example",
    "report_type": "auctions"
  },
  "data": {
    "current": { "price": 120, "bid_count": 4 },
    "previous": { "price": 100, "bid_count": 3 },
    "changes": { "price_delta": 20, "bid_count_delta": 1 }
  }
}

用户任务

kind=user 没有筛选，也没有报告列表。usertask.created 在任务保存时触发一次。usertask.completed 在任务完成时触发一次。不发送进度 tick。载荷给出任务名和报告数量，而不是任务里的每个域名。

curl https://api.karma.domains/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "user",
    "url": "https://hooks.example.com/karma",
    "events": ["usertask.created", "usertask.completed"]
  }'

你收到的事件

{
  "id": "evt_example",
  "type": "usertask.completed",
  "version": "1",
  "subscription_id": "sub_example",
  "object": {
    "task_id": "665f0task",
    "report_type": "expired"
  },
  "data": {
    "current": { "task_name": "French plumbing", "reports_count": 12 }
  }
}

投递使用 Standard Webhooks 签名。每个 POST 含 webhook-id、webhook-timestamp 和 webhook-signature。whsec_ 密钥只返回一次，在创建和轮换时。发送 POST /v1/webhooks/{id}/ping 可投递 webhook.ping 并确认 URL。

常见问题

这和 Public API 是同一把密钥吗？

是。从个人资料 → 开发者拿一把 Pro 密钥，用于 REST、MCP 和 webhook。创建和更新订阅计入共享的每分钟 60 次请求。

Webhook 的限额是多少？

每账户 30 个订阅，每个 UTC 日 5,000 次投递。超过每日上限后，订阅变为 quota_paused，直到下一个 UTC 日。你也可以用 PATCH 自己暂停订阅。

可以订阅哪些事件？

kind=filter 只接受 domain.matched_filter。kind=reports 接受 auction.price_changed、auction.bid_count_changed、auction.ending_soon、auction.ended、report.note_changed、report.tags_changed 和 report.favorite_changed。kind=user 接受 usertask.created 和 usertask.completed。

为什么事件里没有 Majestic（或其他指标）？

报告数据在后台陆续到达，不是一次到齐。不要求某项指标的筛选，可以在该指标出现之前就命中。低优先级报告可能永远拿不到它。

应该把必需指标写进筛选吗？

如果你只要已经有这项指标的报告，就写进去。这会缩小范围，并可能把事件推迟到指标采集完成。对过期域名，这段延迟很重要 — 你等待时，域名可能已经离开信息流。如果要最早的信号，就不要把指标放进筛选，收到 POST 后再自己核对。

指标通常按什么顺序出现？

先是拍卖数据，然后是 Karma Metric，然后是 Karma Score 和存档内容，然后是 SEO 指标（Majestic、Moz、Ahrefs 等），最后是 Google 数据。没有固定等待时间。后面的步骤可能被跳过。

备注和收藏事件会发给所有关注该报告的人吗？

不会。这些事件只发给做出备注、标签或收藏更改的那个账户的订阅。另一个账户为了价格关注同一份报告时，仍然只收到拍卖事件。

请求模式在哪里？

类型和试调控制台在 Swagger UI。Public API 页面涵盖搜索、报告和其余 REST。

面向过期域名的 Webhook

连接 Zapier、Make、n8n 或 IFTTT

三种订阅方式

筛选命中

指定报告

用户任务

常见问题

这和 Public API 是同一把密钥吗？

Webhook 的限额是多少？

可以订阅哪些事件？

为什么事件里没有 Majestic（或其他指标）？

应该把必需指标写进筛选吗？

指标通常按什么顺序出现？

备注和收藏事件会发给所有关注该报告的人吗？

请求模式在哪里？

登记一个 HTTPS 端点，开始接收事件