数据提供方与 API 合作伙伴
大多数 KDP123 工具完全在你的浏览器里运行。少数需要实时数据,例如 Amazon 分类榜或关键词短语。这些请求经 KDP123 自己的服务器转到具名提供方,工具会显示一行“数据来自”,说明是谁回答的、发送了什么。
请求如何处理
- 没有账户,没有 Cookie。KDP123 在转发前会去掉 Cookie 和登录头,并丢弃提供方返回的任何 Cookie。提供方看不到你的 KDP123 会话,因为根本没有会话。
- 只发送工具需要的内容。下面每个接口都写明它到底发送什么,例如你输入的短语。你的其他输入留在浏览器里。
- 只读且有速率限制。只转发发往已列出路径的 GET 请求,我们的服务器按 IP 限制,提供方也有自己的每日上限。
- 静默失败。如果某个提供方不可用,需要它的那一部分会隐藏;其余部分继续工作。
当前提供方
KDPTop与 KDP123 同一团队
KDPTop 每天抓取 Amazon.com 约 11,000 个图书 (Books) 和 Kindle 商店分类的畅销榜和新品榜。 添加于 2026-11-10。 术语.
| 接口 | 它返回什么 | 发送 | 上限 | 使用者 |
|---|---|---|---|---|
GET /api/kdptop/placement/resolve | 按 ASIN、ISBN 或 Amazon 链接查询图书的分类 | 你粘贴的 ASIN、ISBN 或链接,以及格式 | 每位访客每天 10 次查询 | 分类查找 |
GET /api/kdptop/placement/recommend | 与图书描述相匹配的分类 | 你输入的描述和格式 | 每位访客每天 30 次查询 | 分类查找 |
GET /api/kdptop/category/{node_id} | 某个 Amazon 分类的最新快照 | 分类编号 | 每位访客每天 60 次查询 | 分类查找 |
GET /api/kdptop/keywords/suggest | 来自 KDPTop 关键词库的相关搜索短语 | 你输入的种子短语 | 每位访客每天 30 次查询 | 关键词生成器 |
GET /api/kdptop/bsr-curve | KDPTop 使用的 BSR 与销量换算曲线 | 无 | 缓存一小时 | BSR 换算销量 |
GET /api/kdptop/today | 首页使用的今日突围新书和榜单数量 | 无 | 缓存十分钟 | 首页“今日 KDP”条 |
接入你的 API
如果你运营一项 KDP 数据服务,并希望有一个免费的 KDP123 工具来使用它,API 必须全部满足以下条件:
- 无需登录即可使用。访客使用工具时不需要注册或连接账户。
- 不追踪访客。没有 Cookie、没有指纹,也不转卖查询。我们只发送查询本身,以及一个用于速率限制的转发 IP。
- 署名和链出可以,付费墙不行。工具会显示你的名字,以及一个指向你网站的“打开”链接。核心答案必须能在 KDP123 上直接使用。
- 免费,且不影响排名。我们不为数据付费,提供方也不付费给我们。提供数据从不会改变你自己条目的排序或描述。
- 写明的限制。请告诉我们每位访客的每日上限和响应缓存时间,工具才能把它们显示出来。
- 有来源的数字。用一句话说明数据如何收集,这句话可以显示在数字旁边。
每个提供方在我们的服务器上有一条 /api/p/<provider>/ 路径、一条 data/providers/<provider>.yml 记录和一条转发规则;模板在仓库中。请把 API 文档发到 hello@kdp123.com。
调用 KDP123 自身
目录是开放数据:tools.json 和 tools.csv(CC BY 4.0)。每个计算器的公式和 URL 参数都在 calculators.json 里,因此 /free-tools/royalty-calculator/?price=12.99&pages=300 这样的链接会打开已填好的结果。