开发者

Unsubscribe Intelligence API 文档

退订导航与摩擦评分公开 API：查询服务目录、获取逐步退订指南与六维取消难度分析。无需密钥。

基础地址https://api.unsubscribetool.com

接口列表

统一响应信封:{ code, data, message } · code: "0" = OK

GET/api/v1/services服务目录列表

分页返回服务目录。可选参数：q（关键字）、cat（分类 slug）、page（默认 1）。

请求示例

curl "https://api.unsubscribetool.com/api/v1/services?q=netflix&page=1"

响应示例

{ "code": "0", "data": { "items": [ /* … */ ], "total": 203 } }

GET/api/v1/services/:slug单个服务详情

返回某个服务的完整目录记录：步骤、陷阱、摩擦分与来源链接。

请求示例

curl "https://api.unsubscribetool.com/api/v1/services/netflix"

响应示例

{ "code": "0", "data": { "service": "Netflix", "steps": [ /* … */ ], "friction": { /* … */ } } }

GET/api/v1/categories分类列表

返回全部浏览分类及每个分类的服务数量。

请求示例

curl "https://api.unsubscribetool.com/api/v1/categories"

响应示例

{ "code": "0", "data": { "categories": [ /* … */ ] } }

POST/api/v1/guide退订指南

逐步退订流程，含陷阱提示与解释文案。请求体：{ slug, options?: { tone?: "neutral"|"reassuring"|"terse", locale?: string } }。限流 20 次/分钟。

请求示例

curl -X POST "https://api.unsubscribetool.com/api/v1/guide" \
  -H "Content-Type: application/json" \
  -d '{"slug":"netflix"}'

响应示例

{ "code": "0", "data": { "entry": "Netflix", "steps": [ /* … */ ], "traps": [ /* … */ ], "explanation": "…", "source_url": "…" } }

POST/api/v1/analyzer摩擦分析

返回某服务跨六个维度的取消难度评分与逐项解释。请求体：{ slug }。

请求示例

curl -X POST "https://api.unsubscribetool.com/api/v1/analyzer" \
  -H "Content-Type: application/json" \
  -d '{"slug":"netflix"}'

响应示例

{ "code": "0", "data": { "friction": { /* … */ }, "difficulty": 5.4, "tier": "Moderate", "why": [ /* … */ ] } }

POST/api/v1/link-check链接健康核验

异步排队重新核验某服务的退订链接。请求体：{ slug }。返回 202。

请求示例

curl -X POST "https://api.unsubscribetool.com/api/v1/link-check" \
  -H "Content-Type: application/json" \
  -d '{"slug":"netflix"}'

响应示例

{ "code": "0", "data": { "queued": true }, "message": "" }

目录与分类为公开只读接口，无需任何密钥。AI 指南 / 分析接口由服务端自有密钥驱动，调用方无需自备密钥；仅当服务端密钥临时不可用时返回 503（LLM_UNAVAILABLE）。

限流：/guide 20 次/分钟，/link-check 30 次/分钟（按客户端 IP）。超过时返回 429（RATE_LIMITED）。

需要在你的产品中使用这些数据？获取 Cancellation Intelligence 数据集