# 豆瓣数据采集 API 推荐（2026）：三类方案怎么选

> 豆瓣有官方 API 吗？2026 年实测：官方入口要授权，开源项目多数停更或要 Cookie，按次付费接口短评每千条 0.0139 美元、长评 24 美元。

- Canonical page: [https://everyinfra.com/blog/douban-data-api-recommendation](https://everyinfra.com/blog/douban-data-api-recommendation?utm_medium=ai_doc&utm_campaign=page_md)
- Published: 2026-11-21T01:40:00+08:00 · Fact-checked: 2026-11-21T01:05:00+08:00

有现成的豆瓣接口，分三类：豆瓣自己的开放接口（2018 年起不再对个人开放，商用要找豆瓣书面授权）、GitHub 上的开源爬虫和 MCP 小工具（免费，但星多的大多停更，2026 年还在更新的几个多数要 Cookie 或登录）、按次付费的数据接口（不用自己维护，按调用次数付钱）。下面比较的方案里有一家是 EveryInfra 自己的接口，我们是厂商，文中我们这一侧的价格和返回都来自 2026 年 11 月 21 日新加坡时间 00:13 读取的目录和 00:19–00:31 的 17 次真实请求。同在豆瓣，我们按次付费的价格按数据类型能差 1,700 倍：一次调用拿 100 条热门短评只要 0.001389 美元，折合每千条 0.0139 美元；长评按条计费，每千条 24 美元。

> **要点**
>
> - 豆瓣官方：2026-11-21 00:16 我们直接请求 `api.douban.com/v2/movie/top250`，返回 HTTP 403 和 `invalid_apikey, Please contact bd-team@douban.com for authorized access.`；developers.douban.com 在互联网档案馆的快照记录停在 2018-08-22（那一条是 301 跳转），2019 年以后没有记录。
> - 豆瓣《法律声明》第二节写明，未取得书面许可不得把豆瓣网内容用于数据统计、分析报告、舆情监测等用途，授权联系 bd-team@douban.com。这份许可只能向豆瓣申请，你的用途对应哪一条，请自行核对条款原文。
> - GitHub 上我们读了 18 个豆瓣仓库的仓库信息、提交记录和说明文件（没有运行这些代码）：星最多的 5 个只有 1 个在 2025 年后还有提交；2026 年有提交的 5 个都是 MCP 或命令行小工具，星数 0～62。
> - EveryInfra 目录里豆瓣有 4 项能力：`douban/search`、`douban/comments`、`douban/group_topic` 每次 0.001389 美元，`douban/reviews` 每条 0.024 美元。本轮图书短评、长评、小组话题和搜索都取到了数据；电影条目的短评两次都是空结果、没扣费。
> - 本轮 17 次请求合计扣费 0.058501 美元：1 次 422 参数错误和 7 次空结果都是 0 元，图书条目一次拿到 100 条短评。

## 豆瓣有官方 API 吗？

豆瓣有过一套完整的开放接口。互联网档案馆保存的 [2018 年 6 月 26 日的开发者站首页](https://web.archive.org/web/20180626151022/https://developers.douban.com/)写着，开发者可以接入豆瓣社区、读书、电影、音乐、同城等产品的内容和基于兴趣的用户关系，页面底部还有「用豆瓣帐号登录」的入口。豆瓣官方的 Python 客户端 [douban/douban-client](https://github.com/douban/douban-client) 在说明里写过当时的配额：不需要授权的公开接口可以用 HTTP 调，不带 apikey 时单个 IP 每分钟限 10 次。这个仓库最后一次提交是 2014-06-22，现在已经归档，有 741 颗星。

开放平台什么时候关的，豆瓣没有发过一份我们能找到的正式公告。我们用两份能复核的原始记录来定时间。第一份是互联网档案馆的 [CDX 查询接口](https://web.archive.org/cdx/search/cdx?url=developers.douban.com&output=json&fl=timestamp,statuscode&collapse=timestamp:6)：按月去重后，developers.douban.com 一共有 44 条快照记录，第一条是 2012-08-05；状态 200 的最后一条是 2016-12-27，此后到 2018-08-22 的记录都是 301 跳转，2019 年以后一条都没有。第二份是开发者自己的记录：一位作者在 2022 年整理的[豆瓣逃离计划](https://ulyc.github.io/2022/02/11/Douban-Escape-Plan/)列出「2018 年 9 月豆瓣开放平台下线；2019 年 4 月图书 api 无法使用；2020 年各电影 api 无法使用」，[V2EX 2020-08-18 的帖子](https://v2ex.com/t/699393)记录了网上流传的几个 apikey 在同一天一起失效，报错是 `invalid_credencial2`。两份记录的时间对得上：快照记录在 2018 年 8 月底停止，开发者感知到的下线在 2018 年 9 月。

![柱状图：developers.douban.com 在互联网档案馆每年的快照数，2012 年 2 份、2013 年 8 份、2014 年 7 份、2015 年 8 份、2016 年 7 份、2017 年 7 份、2018 年 5 份，2019 到 2026 年都是 0。最后一条记录是 2018 年 8 月 22 日的 301 跳转。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-03-developer-site-timeline.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

2026 年的现状，我们在 11 月 21 日新加坡时间 00:16 直接请求了两次旧接口。`https://api.douban.com/v2/movie/top250` 返回 HTTP 403，错误码 104，消息原文是 `invalid_apikey, Please contact bd-team@douban.com for authorized access.`；`https://api.douban.com/v2/book/1220562` 返回 HTTP 400，错误码 131，消息是 `apikey_required`。接口域名还在应答，只是不接受匿名请求，并且明确让人去找豆瓣商务团队要授权。同一时间 developers.douban.com 的域名能解析到豆瓣的转发服务器，HTTPS 请求却没有任何响应，curl 记为状态 000。

![截图：两次请求豆瓣旧接口的原始返回。top250 接口返回 HTTP 403，msg 为 invalid_apikey 并要求联系 bd-team@douban.com 取得授权；图书接口返回 HTTP 400，msg 为 apikey_required。](https://everyinfra.com/articles/douban-data-api-recommendation/img-douban-api-403.webp?utm_medium=ai_doc&utm_campaign=page_md)

2026-11-21 00:16（新加坡时间）请求 api.douban.com 的原始响应，青绿框是错误消息 [豆瓣 api.douban.com 原始返回](https://api.douban.com/v2/movie/top250)

官方这条路现在要什么资质？我们 2026-11-21 核对的公开文档里，没有自助申请 apikey 的页面，也没有价格、配额和审核标准。能找到的唯一入口在豆瓣的[《法律声明》](https://www.douban.com/about/legal)第二节第 3 条：「如需使用豆瓣网内容，请联系豆瓣（邮箱：bd-team@douban.com）并取得相应的授权。」这和旧接口报错里给的邮箱是同一个。所以对「豆瓣有官方 api 吗」的回答是：接口还在，个人开发者拿不到 key；企业要用，走商务洽谈，条件不公开。

| 官方渠道 | 2026-11-21 核对结果 | 能拿到什么 | 门槛 |
| --- | --- | --- | --- |
| api.douban.com v2 | 匿名请求返回 403 `invalid_apikey` 或 400 `apikey_required` | 有授权 key 时的书影音条目数据（旧文档范围） | 豆瓣发给的 apikey，公开渠道不发 |
| developers.douban.com | 域名能解析，HTTPS 无响应；快照记录停在 2018-08-22（301 跳转） | 无 | 无入口 |
| 商务授权 bd-team@douban.com | 《法律声明》第二节第 3 条写明的联系方式 | 视协议而定，公开文档没有写 | 书面授权，条件不公开 |
| 豆瓣 App 内部接口 | 开源项目说明里写要签名和登录（见下一节） | 和 App 看到的一样 | 签名常量、账号、短信验证 |

《法律声明》第二节第 2 条还列了一份需要书面许可的用途清单，范围很宽：直接或加工后作为数据产品销售，在商业产品中展示豆瓣评分和用户评论，用于大语言模型训练，用于数据统计、分析报告、舆情监测、商业营销，以及「侵犯或可能侵犯豆瓣权益的数据采集、网络爬虫」。豆瓣[《使用协议》](https://www.douban.com/about/agreement)的现行版本是 2025 年 5 月 27 日公布的修订版，第 9.6 条另外禁止干扰和破解网络服务。这两份文件对下面三类方案一视同仁：开源脚本、按次付费接口、你自己写的爬虫，都只解决「技术上拿得到」，解决不了「豆瓣是否许可」。

![截图：豆瓣《法律声明》第二节第 2、3 条原文。青绿框标出三处：未取得豆瓣书面许可前不得以任何目的使用豆瓣网内容；用于数据统计、分析报告、舆情监测、商业营销等；如需使用请联系 bd-team@douban.com 取得授权。](https://everyinfra.com/articles/douban-data-api-recommendation/img-douban-legal.webp?utm_medium=ai_doc&utm_campaign=page_md)

豆瓣《法律声明》「信息和数据」一节原文，2026-11-21 读取 [豆瓣《法律声明》](https://www.douban.com/about/legal)

如果决定走授权这条路，给 bd-team@douban.com 的第一封邮件最好把对方审核时要看的信息一次写全：你是谁、要哪几类内容（条目基础信息、评分、短评、长评、小组）、大致的量和频率、数据放在哪里、会不会对外展示或出售、要不要用于模型训练。《法律声明》列出的需要许可的用途正好可以当清单逐项回答。豆瓣没有公开授权的价格和审批时长，我们也没有这方面的一手信息，这里只给写邮件的思路。

我们不提供法律意见，只把原文摆出来。《法律声明》第二节第 2 条列出的用途里有「舆情监测」「分析报告」，没有单独写个人读书笔记或课程作业；你的用途落在哪一条，请自行核对条款原文，必要时问法务。

## 视频教程里教的旧写法还能用吗？

我们用 `youtube/search` 搜了「豆瓣 API」，取前 3 个相关视频：[《使用Python开发豆瓣API》](https://www.youtube.com/watch?v=nrk09RQMfWE)（2022-08-11 上传，26 次播放）、[《RESTful API简介及调用豆瓣API》](https://www.youtube.com/watch?v=6udBuOr8LXA)（2019-06-19，124 次）、[《服务器端通过 request 向豆瓣 api 请求详细数据》](https://www.youtube.com/watch?v=lJHhSeipDgU)（2021-10-08，27 次）。三个视频都没有字幕，`youtube/transcript` 返回空结果、没有扣费，所以我们只能从标题和简介判断内容：它们演示的都是直接请求 api.douban.com 的旧接口。按上一节 00:16 的实测，照视频里的写法跑，第一步就会收到 `invalid_apikey` 或 `apikey_required`。搜索结果前 10 条里还有一个 2024 年的 App 逆向签名教程，做法是破解客户端签名；《使用协议》第 9.6 条写有禁止破解网络服务的条款，我们不展开。

## 有没有现成的豆瓣接口？三类方案总对比

有，三类都现成：向豆瓣申请的书面授权、开源项目、按次付费接口。三类的差别集中在五件事上：谁来维护、要不要豆瓣账号和 Cookie、失败了算谁的钱、能不能直接接进 AI 工具、豆瓣的书面许可谁去拿。EveryInfra 一列的数来自目录和真调，开源一列来自 GitHub 接口的原始数据，官方一列来自上一节的请求记录；其他按次付费服务我们不点名，只列比较时要核的项。

| 比较项 | 豆瓣书面授权 | GitHub 开源项目 | EveryInfra 按次付费 | 其他按次付费服务 |
| --- | --- | --- | --- | --- |
| 计费单位 | 协议约定，公开文档没有 | 免费，自付服务器和代理 | 每次调用；长评按条 | 看各家定价页 |
| 每千条短评 | 不公开 | 0（不算人力和代理） | 0.0139 美元（每次 100 条） | 要核每次返回条数 |
| 每千条长评 | 不公开 | 0 | 24 美元（每条 0.024） | 要核是按次还是按条 |
| 失败和空结果 | 协议约定 | 自己承担 | 不扣费（本轮 7 次空结果、1 次 422 均为 0 元） | 要核退款规则 |
| 要不要豆瓣账号或 Cookie | 要授权 key | 18 个里 8 个的说明写到 Cookie 或登录 | 不要 | 要核 |
| 能不能接 MCP | 无 | 有 6 个 MCP 或命令行项目，多数在本机跑 | 远程 MCP，12 个工具 | 要核 |
| 有没有豆瓣书面许可 | 有（签了协议的话） | 没有 | 没有，要用户自己去取得 | 没有 |
| 维护 | 豆瓣 | 作者个人，多数停更 | 我们 | 各家 |

![示意图：一张长桌上摆着三样东西。左边是一个上了锁的灰色信箱，前面放着一封封好的信，代表要向豆瓣书面申请的授权；中间是一个打开的工具箱，里面有齿轮、扳手和一罐饼干，代表要自己维护、常常要登录 Cookie 的开源脚本；右边是一台青绿色的小售卖机，投币口旁吐出印着星级和胶片图案的卡片，代表按次付费的接口。](https://everyinfra.com/articles/douban-data-api-recommendation/img-three-stations.webp?utm_medium=ai_doc&utm_campaign=page_md)

三类方案：书面授权、自己维护、按次付费 | source: EveryInfra 绘制的示意图，不代表任何真实产品

按次付费接口省掉的是抓取、解析、重试和计费这些工程时间，不替你和豆瓣签协议。

## GitHub 上的豆瓣开源项目还能用吗？

我们在 2026-11-21 新加坡时间 00:17 用 [GitHub 搜索接口](https://docs.github.com/en/rest/search/search)查了 5 组词（douban api、douban spider、douban crawler、豆瓣 爬虫、douban mcp），按星数排序各取前 15 个，去掉只是顺带提到豆瓣的合集仓库，留下 18 个以豆瓣为主的仓库，再逐个读了仓库信息、最近一次提交和说明文件。18 个仓库合计 8,301 颗星。

| 仓库 | 星数 | 最后提交 | 许可证 | 要不要 Cookie 或登录 | 用途 |
| --- | --- | --- | --- | --- | --- |
| [lanbing510/DouBanSpider](https://github.com/lanbing510/DouBanSpider) | 2,791 | 2020-04-08 | 未声明 | 说明里没写 | 豆瓣读书爬虫 |
| [fugary/calibre-douban](https://github.com/fugary/calibre-douban) | 1,385 | 2025-11-08 | Apache-2.0 | 说明里没写 | Calibre 图书元数据插件 |
| [iphysresearch/TOP250movie_douban](https://github.com/iphysresearch/TOP250movie_douban) | 1,032 | 2019-04-12 | BSD-2-Clause | 说明写每个爬虫先登录 | Top250 短评爬取和情感分析 |
| [baabaaox/ScrapyDouban](https://github.com/baabaaox/ScrapyDouban) | 789 | 2022-01-14 | 未声明 | 说明里没写 | 电影和读书 Scrapy 爬虫 |
| [douban/douban-client](https://github.com/douban/douban-client) | 741 | 2014-06-22（已归档） | 未声明 | 要 apikey | 豆瓣官方旧 API 客户端 |
| [fugary/calibre-web-douban-api](https://github.com/fugary/calibre-web-douban-api) | 464 | 2024-06-09 | Apache-2.0 | 说明里没写 | Calibre-Web 图书元数据 |
| [JimSunJing/douban_crawler](https://github.com/JimSunJing/douban_crawler) | 204 | 2022-05-09 | MIT | 说明里没写 | 备份个人豆瓣记录 |
| [kxy000/doubanapi](https://github.com/kxy000/doubanapi) | 181 | 2020-05-26 | 未声明 | 无代码 | 旧 API 文档备份 |
| [wanglin2/douban_api](https://github.com/wanglin2/douban_api) | 179 | 2022-06-19 | MIT | 说明里没写 | 自建豆瓣 API 服务 |
| [kaito-kidd/douban-group-spider](https://github.com/kaito-kidd/douban-group-spider) | 163 | 2021-01-08 | 未声明 | 说明里没写 | 小组帖子爬虫 |
| [cxfksword/douban-api-rs](https://github.com/cxfksword/douban-api-rs) | 148 | 2022-10-21（已归档） | MIT | 可选 Cookie | 给 Jellyfin 刮削影片 |
| [acdzh/douban-book-api](https://github.com/acdzh/douban-book-api) | 117 | 2023-01-30 | MIT | 说明里没写 | 第三方读书 API |
| [AaronZ345/douban-cli](https://github.com/AaronZ345/douban-cli) | 62 | 2026-10-22 | MIT | 账号操作要登录 | 命令行和 MCP |
| [jackjin1997/douban-mcp](https://github.com/jackjin1997/douban-mcp) | 20 | 2026-11-17 | MIT | 详情页要 Cookie | MCP 服务 |
| [moonlin1213/cove-douban-mcp](https://github.com/moonlin1213/cove-douban-mcp) | 15 | 2026-08-29 | Apache-2.0 | 用本机 Chrome 的登录会话 | 只读 MCP |
| [yoyooyooo/douban-mcp](https://github.com/yoyooyooo/douban-mcp) | 9 | 2025-03-23 | 未声明 | 配置里要填 Cookie | MCP 服务 |
| [openplayx/mcp-douban](https://github.com/openplayx/mcp-douban) | 1 | 2026-11-17 | MIT | 影视接口免登录，通用搜索要登录 | HTTP 接口和 MCP |
| [BugenZhao/douban-mcp](https://github.com/BugenZhao/douban-mcp) | 0 | 2026-10-25 | 未声明 | 账号密码登录，可能要短信验证 | MCP，走 App 接口 |

![横向条形图，对数刻度：18 个豆瓣相关 GitHub 仓库按星数排列。最高的 DouBanSpider 2,791 星，最后提交 2020-04-08；calibre-douban 1,385 星，2025-11-08；TOP250movie_douban 1,032 星，2019-04-12；ScrapyDouban 789 星，2022-01-14；douban-client 741 星，2014-06-22。2026 年有提交的 5 个都标成青绿：douban-cli 62 星、douban-mcp（jackjin1997）20 星、cove-douban-mcp 15 星、mcp-douban 1 星、douban-mcp（BugenZhao）0 星。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-02-github-repos.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

星数和活跃度反着走。星最多的 5 个仓库里，只有 calibre-douban 在 2025 年后还有提交；按最后提交年份数，2022 年 4 个、2020 年 2 个、2019 年、2021 年、2023 年、2024 年各 1 个，2014 年 1 个，这 11 个合计 6,809 颗星。2026 年有提交的 5 个仓库合计只有 98 颗星。星数大多是旧接口还能用的年代攒下的，用星数来挑仓库，挑到的多半是停更的代码。

2026 年还在更新的项目都转向了 MCP，多数要用账号。jackjin1997/douban-mcp 的说明写得很具体：搜索和 Top250 这类聚合页匿名可用，单个电影、图书详情页「会被豆瓣风控重定向到 sec.douban.com，必须配置 DOUBAN_COOKIE 才能稳定访问」；它原来还有一条走豆瓣 App 接口的备用通道，因为服务端要求签名（报错 `invalid_request_997 签名缺失`）已经删掉。BugenZhao/douban-mcp 走的正是 App 接口，用的是 App 里的共享客户端常量做签名，再用账号密码登录，遇到账号保护错误 9000 时会触发短信验证。moonlin1213/cove-douban-mcp 选了另一条路：不导出 Cookie，直接借用你本机 Chrome 里已经登录的豆瓣会话。openplayx/mcp-douban 只用移动网页的影视接口，说明里写这些接口不要登录，但通用搜索要登录，被拒绝时返回专门的拒绝错误码，原因写的是访问规则变化、IP 被封或限流。

18 个里有 7 个没有声明许可证。[GitHub 的帮助文档](https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository)写的是，没有许可证时默认适用版权法，作者没有授予复制、分发和修改的权利；具体怎么适用请自行核对。另有 2 个已经归档，作者不再更新。拿这些代码做内部工具前，先看许可证这一列。

有两类用途已经有专门的项目。要给 Calibre 或 Calibre-Web 的个人书库补豆瓣元数据，fugary 的两个插件就是为这件事写的，calibre-douban 的仓库简介写的是「Douban no longer provides book API」；要把自己的豆瓣标记导出备份，JimSunJing/douban_crawler 和上文提到的逃离计划都是只读自己主页的工具，不需要接口。这两类都是个人数据、个人用途，和批量采集别人的评论是两回事。

开源脚本跑在你自己的机器和网络上，豆瓣的风控面对的是你的 IP 和你的账号。2021 年的一篇动画电影短评研究（[Wu 等，Entertainment Computing](https://doi.org/10.1016/j.entcom.2020.100391)）在 Google Scholar 收录的摘录里提到豆瓣电影的 IP 限制给数据采集带来了麻烦；V2EX 上 2020 年的讨论里，有人提醒「页面解析的话过于暴露，容易触碰反爬」。豆瓣的 [robots.txt](https://www.douban.com/robots.txt) 对所有爬虫禁止 `/search`、`/subject_search`、`/j/`、`/people/*/collect` 等 29 条路径，`Crawl-delay: 5` 这一行写了但被注释掉了，[movie.douban.com 的 robots.txt](https://movie.douban.com/robots.txt) 和主站逐字节相同。robots.txt 的规则含义见 [RFC 9309](https://datatracker.ietf.org/doc/html/rfc9309)：它是给爬虫的访问请求，本身不是访问控制。

## 自己写一个豆瓣爬虫要过哪几关

三类方案之外还有第四条路：自己写。开源仓库的说明把要过的关写得很清楚，我们按出现的先后排一遍。第一关是频率，TOP250movie_douban 的说明写着每个爬虫都设了 1.8 秒的下载间隔，并且一般只让两三个爬虫并行，「以免被 ban」。第二关是登录，同一个项目的每个爬虫都是先登录、再跳到目标页面；jackjin1997/douban-mcp 在 2026 年的说明里写，详情页不带 Cookie 会被重定向到 sec.douban.com。第三关是签名，豆瓣 App 的接口要求请求带签名，没有签名直接报错，能用的项目只能内置 App 的客户端常量。第四关是页面改版，acdzh/douban-book-api 的说明提醒，抓 HTML 解析「有一定概率遭到反爬限制或数据解析失败」，规则失效要靠作者更新。

四关加起来，自己写的成本主要是持续维护：一个账号、一组代理、一份会随页面改版失效的解析规则，以及出问题时停下来修的时间。按下面月度账一节的假设，同样的短评和小组跟踪用按次付费接口一个月 0.46 美元；自己写省下这笔钱，换来的是这四关都要自己守。数据量小、只跑一两次的研究项目，自己写一个脚本很合理；要每周稳定跑、结果要进报表的，维护成本会超过接口费。

## 豆瓣 api 哪家好：按次付费接口比什么

按次付费接口要比的是五个数：每次调用返回几条、每条多少钱、失败和空结果扣不扣、字段齐不齐、要不要你提供账号。价格表上的「每次」只说了一半，同样每次 0.001389 美元，一次返回 100 条和一次返回 3 条，每千条的成本差 33 倍。

我们这一侧的目录是公开的，不用 Key 就能读：[豆瓣能力目录](https://api.everyinfra.com/api/v1/social/catalog?platform=douban)。2026-11-21 新加坡时间 00:13 读取的精简目录里有 106 个平台、626 项能力，其中 591 项标为可用；豆瓣 4 项都标为可用。

| 能力 | 计费 | 目录写的默认和上限 | 参数 | 目录列出的返回字段数 |
| --- | --- | --- | --- | --- |
| [`douban/search`](/douban-api/search) 书影音条目搜索 | 每次 0.001389 美元 | 默认 20，最多 50 | `keyword`，`type` 取 all、movie、book、music | 14 |
| [`douban/comments`](/douban-api/comments) 短评 | 每次 0.001389 美元 | 默认 20，最多 200 | 条目链接 `url` | 14 |
| [`douban/reviews`](/douban-api/reviews) 长评 | 每条 0.024 美元 | 默认 15，最多 50 | 条目链接 `url` | 16 |
| [`douban/group_topic`](/douban-api/group_topic) 小组话题和回复 | 每次 0.001389 美元 | 每次 1 个话题，回复默认 20、最多 100 | 话题链接 `url`，`max_replies` | 13 |

![横向条形图，对数刻度：每 1,000 条记录的接口费。短评每次 100 条，每千条 0.0139 美元；搜索本轮 3 次返回 7 个条目，每千条 0.60 美元；小组话题每次 1 个，每千个 1.39 美元；长评按条计费，每千条 24.00 美元。短评和长评相差约 1,700 倍。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-01-cost-per-1000.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

四个数都按实际返回的行数算。短评 `douban/comments` 在 00:26 新加坡时间那次传了 `limit=100`，返回 100 条、扣 0.001389 美元，每千条 0.0139 美元。长评 `douban/reviews` 的计费是每条 0.024 美元，00:26 那次要了 2 条，扣 0.048 美元，响应里 `units` 是 2、`rows_per_unit` 是 1。两项之比 24 ÷ 0.0139 ≈ 1,727。长评的入口是条目链接，例如[《三体》的图书条目](https://book.douban.com/subject/2567698/)；单篇长评在豆瓣上有自己的页面，比如 2026-11-11 发布的[一篇《飞行家》影评](https://m.douban.com/movie/review/17895673/)，但目录里的 `douban/reviews` 按条目取一组长评，不按单篇长评链接取。差价的来源是内容：返回的两篇长评都发于 2008 年 4 月，一篇 4 星「推荐」、一篇 5 星「力荐」，回应数分别是 268 和 149，每篇带标题、星级、回应数和原文链接，正文分别有 3,265 和 1,283 个字，100 条短评正文的中位数只有 45.5 个字、最长 367 个字。要做文本挖掘、情感分析，短评的量和价格都合适；要读一篇完整的书评或影评，才值得用长评。

搜索的每千条成本高，原因是返回条数少。目录写默认 20 条，本轮三次搜索返回的分别是 3、3、1 条：搜「千里江山图」（限定影视）返回 1 部电影、2 部剧集；搜「三体」（限定图书）返回三部曲；搜「流浪地球」（不限类型）只返回了 2016 年的同名图书，没有电影。三次合计 0.004167 美元拿到 7 个条目，折合每千条 0.60 美元。搜索在这里的用途是把书名、片名换成条目链接，后面的短评、长评都要用这个链接，所以搜索的总花费通常很小。

其他按次付费服务比较时，我们建议核同样几项：一次调用实际返回几条（不看文档写的上限，看真实返回）、长评这类大字段是不是另行计价、空结果和平台拒绝时扣不扣钱、要不要你提供豆瓣 Cookie、有没有远程 MCP。拿同一个条目链接在几家各调一次，看返回条数和账单，比读定价页可靠。

## 一次实测：三轮 17 次请求拿到了什么

2026 年 11 月 21 日新加坡时间 00:19 到 00:31，我们分三轮发了 17 次请求。第一轮在 00:19–00:23，做搜索、短评、小组话题和视频检索；第二轮在 00:26，测长评和 100 条短评；第三轮在 00:29–00:31，测电影短评、小组回复上限和不限类型的搜索。

| 新加坡时间 | 能力 | 参数要点 | 返回 | 扣费（美元） |
| --- | --- | --- | --- | --- |
| 00:19:00 | `douban/search` | 千里江山图，movie | 3 个条目（1 电影、2 剧集），耗时 35.7 秒 | 0.001389 |
| 00:19:50 | `douban/search` | 三体，book | 3 个条目 | 0.001389 |
| 00:20:04 | `douban/comments` | 未开播的剧集条目 | 0 条，空结果未扣费 | 0 |
| 00:20:26 | `douban/group_topic` | 电影票房小组一个话题 | 1 个话题、20 条回复 | 0.001389 |
| 00:21:03 | `douban/comments` | 《三体》图书，默认条数 | 20 条 | 0.001389 |
| 00:21:32 | `youtube/search` | 豆瓣 API | 10 个视频 | 0.000778 |
| 00:21:41 | `douban/comments` | 故意传用户主页链接 | 0 条，空结果未扣费 | 0 |
| 00:22:00–00:23:16 | `youtube/transcript` | 3 个视频 | 都没有字幕，空结果未扣费 | 0 |
| 00:26:14 | `douban/reviews` | 《三体》，limit=2 | 2 篇长评 | 0.048 |
| 00:26:43 | `douban/comments` | 《三体》，limit=100 | 100 条 | 0.001389 |
| 00:29:52 | `douban/comments` | 《肖申克的救赎》电影，limit=200 | 0 条，空结果未扣费 | 0 |
| 00:30:08 | `douban/group_topic` | 同一话题，max_replies=100 | 24 行回复，去重后 23 条 | 0.001389 |
| 00:30:24 | `douban/search` | 流浪地球，all | 1 个条目（图书） | 0.001389 |
| 00:30:46 | `douban/search` | type=tv | 422，提示只接受 all、book、movie、music | 0 |
| 00:30:59 | `douban/comments` | 《肖申克的救赎》，默认条数 | 0 条，空结果未扣费 | 0 |
| 合计 |  | 17 次请求，9 次扣费 |  | 0.058501 |

![截图：EveryInfra 接口的真实请求和返回。请求体是 platform douban、action comments、url 为《三体》图书条目、limit 100；返回里 count 为 100，前两条短评带正文、5 星力荐、vote_count 13064 和 9190、发布时间 2011 年和 2014 年，作者名已隐去；billing 里 charged_usd 为 0.001389。](https://everyinfra.com/articles/douban-data-api-recommendation/img-api-comments.webp?utm_medium=ai_doc&utm_campaign=page_md)

00:26 新加坡时间的 douban/comments 返回，只保留前 2 条，作者信息已隐去 [EveryInfra 接口真实返回](https://api.everyinfra.com/api/v1/social/catalog?platform=douban)

图书短评默认条数那次返回 20 条，`limit=100` 那次返回 100 条，两次的前 20 条 id 和顺序完全一致，100 条里没有重复 id。每条都带正文、星级（`rating`，满分 `rating_scale` 为 10 时 5 星对应「力荐」）、「有用」数 `vote_count` 和发布时间。100 条的「有用」数从 12 到 13,064，中位数 87。

![柱状图：《三体》热门短评 100 条的星级分布，1 星 20 条、2 星 16 条、3 星 24 条、4 星 15 条、5 星 21 条，没打分 4 条。分布很平，像按星级分档取的热门短评，不能用来估全书评分。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-04-comment-ratings.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

这 100 条短评的星级分布很平：1 星 20 条、2 星 16 条、3 星 24 条、4 星 15 条、5 星 21 条，另有 4 条没打分。一本书的评分分布通常不会这么均匀，这个结果说明返回的是按星级分档挑出的热门短评，适合看「打一星的人在抱怨什么、打五星的人在夸什么」，不适合拿来算平均分。图书条目页上的豆瓣评分要另外取。

![柱状图：同一批 100 条短评的发布年份。2009 年 1 条、2010 年 3 条、2011 年 16 条、2012 年 8 条、2013 年 9 条、2014 年 17 条、2015 年 17 条、2016 年 6 条、2017 年 1 条、2018 年 5 条、2019 年 2 条、2020 年 4 条、2021 年 3 条、2022 年 3 条、2023 年 4 条、2024 年 1 条，2025 和 2026 年 0 条。2011 到 2015 年共 67 条。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-05-comment-years.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

发布时间也印证了「热门」：100 条里 67 条发于 2011 到 2015 年，最新一条是 2024-09-19，2025 年以后的一条都没有。目录里 `douban/comments` 没有排序参数，拿不到「最新短评」。要跟踪一部新上映电影开分后一周的口碑变化，这项能力不够用，要等它积累热门评论，或者改看小组讨论。

小组话题这一项更贴近「最近在聊什么」。我们取的是电影票房小组 2026-11-12 发的[一个话题](https://www.douban.com/group/topic/505471405/)，讨论一部待上映的电影能不能在剧情上超过另一部谍战片。00:20 那次按默认取 20 条回复，00:30 那次把 `max_replies` 设为 100，返回了 24 行，和话题页显示的回复数 24 一致；回复时间分布在 2026-11-14（16 条）、2026-11-15（6 条）和 2026-11-17（2 条）。这 24 行回复的「有用」数从 0 到 33，中位数 7；得票最高的一条（33）引用另一部电影的豆瓣评分 7.3 和票房来反驳楼里说它不好的人，第二高的一条（25）质疑导演能不能拍好剧情片，还有两条各 23 票，一条说剧情上超过对比对象不难，一条提醒同名小说另有剧集改编，该比的是影剧两版。小组回复带时间戳，能看出一部片子上映前后观众拿什么和它比、担心什么；热门短评按「有用」数挑，看不出这个时间顺序。24 行里有两行 id 相同（同一用户同一时刻的一条回复出现了两次），去重后 23 条，入库前要按 `id` 去重。

空结果有三次落在影视条目上：一部 2026 年还没开播的[剧集](https://movie.douban.com/subject/36218470/)，短评为 0 很正常；[《肖申克的救赎》](https://movie.douban.com/subject/1292052/)两次都是 0 条，一次 `limit=200`、一次默认条数。同一时段图书条目的短评正常返回，影视条目的三次短评都是空结果、没扣费。影视口碑可以先用小组话题取；空结果不产生费用，换时段重试也不会多花钱。

![分组柱状图：每项能力目录列出的字段数和本轮每一行都有值的字段数。图书搜索 14 个字段里 8 个每行都有值，影视搜索 14 个里 8 个，短评 14 个里 11 个，长评 16 个全部有值，小组话题 13 个全部有值。图书搜索的 rating、rating_count 为空。](https://everyinfra.com/articles/douban-data-api-recommendation/fig-06-field-coverage.zh.light.svg?utm_medium=ai_doc&utm_campaign=page_md)

字段这一项，长评和小组话题的目录字段每一行都有值，短评 14 个字段里 11 个每行都有、3 个部分有（例如那 4 条没打分的短评没有 `rating`）。搜索返回里评分类字段不全：图书搜索的 `rating`、`rating_scale`、`rating_count` 都是空的，影视搜索的 `rating_count` 返回 0。影视搜索的三个结果都还没上映：「千里·江山图」是 2028 年的电影，另两个同名条目是 2026 年和 2028 年的剧集，评分人数为 0 和这一点对得上；前两个结果带年份、导演和演员表，2026 年那部剧集的演员表有 28 人。图书搜索「三体」返回三部曲三个条目，分别带书名、作者刘慈欣、出版年 2008、2008、2010 和封面链接，条目编号 2567698 就是后面取短评、长评用的那一个。想拿豆瓣评分做选书选片，要另找来源。

错误请求的处理和客户能看到的现象一致：`type=tv` 返回 422，消息写明只接受 all、book、movie、music，没有扣费；请求过快时返回 429，响应里写明没扣费并给出 `retry_after` 秒数，等待后重试即可；故意传一个用户主页链接给 `douban/comments`，返回 200 和空结果、没扣费。按扣费计，17 次请求里 9 次扣费，合计 0.058501 美元，其中 0.048 是两篇长评。退款怎么对账，见[失败退款对账](/build/failure-refund-reconciliation)。

## 100 条短评里能读出什么

拿到数据之后能做什么，用这 100 条《三体》短评试一次。按星级分组看「有用」数的中位数：1 星 45.5、2 星 115.5、3 星 72.5、4 星 148、5 星 100，打 2 星和 4 星的短评被点「有用」的中位数最高。「有用」数最高的 10 条里，5 星 4 条、4 星 2 条、3 星 2 条、1 星和 2 星各 1 条，前两条分别有 13,064 和 9,190 次。100 条里「有用」数过千的有 9 条。

| 星级 | 条数 | 「有用」数中位数 | 正文字数中位数 |
| --- | --- | --- | --- |
| 1 星 | 20 | 45.5 | 48.5 |
| 2 星 | 16 | 115.5 | 34 |
| 3 星 | 24 | 72.5 | 40 |
| 4 星 | 15 | 148 | 34 |
| 5 星 | 21 | 100 | 47 |
| 没打分 | 4 | 46.5 | 84 |

同样的做法换到一部新上映的电影上，会碰到两个限制：热门短评偏老，影视条目本轮没有取到短评。拿短评做口碑分析，本轮能验证的是图书；新片的讨论用小组话题取，回复带时间。

响应时间也要算进流程。本轮 12 次成功返回的豆瓣请求，耗时从 8.5 秒到 35.7 秒，中位数约 15.5 秒，第一次搜索最慢。批量跑几百个条目时，同步等待会拖长整个任务，可以在请求体里加 `"mode":"async"`，先拿任务号，再按返回的地址轮询，响应里的 `async_hint` 写的就是这个用法。

## 豆瓣 api 推荐：按场景怎么选

| 你要做的事 | 建议 | 理由 |
| --- | --- | --- |
| 把豆瓣数据做成产品卖给别人，或在商业产品里展示豆瓣评分 | 先读《法律声明》第二节，按其中的联系方式找 bd-team@douban.com | 第二节第 2 条把这类用途列在需要书面许可的清单里，适用与否自行核对 |
| 给自己的 Calibre 书库补元数据 | fugary/calibre-douban 或 calibre-web-douban-api | 专门为此写的插件，Apache-2.0，calibre-douban 2025-11-08 还有提交 |
| 备份自己的豆瓣标记 | 只读自己主页的导出脚本 | 个人数据，不需要接口 |
| 在 Claude、Cursor 等 AI 工具里随手查几本书、几部片 | 本机 MCP 小工具，或远程 MCP | 量小时开源 MCP 够用，但详情页多要 Cookie；远程 MCP 不用你的账号 |
| 每周拉几十个条目的热门短评做文本分析 | 按次付费 `douban/comments` | 每次 100 条 0.001389 美元，不用维护代理和登录态 |
| 跟踪豆瓣小组里某个话题的讨论 | 按次付费 `douban/group_topic` | 一次带回最多 100 条回复，本轮返回 24 行、去重后 23 条 |
| 读完整的书评、影评 | `douban/reviews`，按条付费 | 每条 0.024 美元，返回全文；量大时先估预算 |
| 要豆瓣评分、评分人数做排序 | 我们的目录没有条目详情能力；可以向豆瓣询问授权 | 本轮图书搜索返回不带评分数 |
| 要新片开分后每天的最新短评 | 本轮按次付费接口给不了 | `douban/comments` 无排序参数，返回的是热门短评 |

做产品之前先回答一个问题：这份数据离开你的电脑以后给谁看。对外提供数据服务、在商业产品里展示评分和评论，都在《法律声明》第二节第 2 条列明须书面许可的用途里；团队内部做研究、写选题、看口碑属于哪一类，条款没有逐项写，请自行核对原文。

## 一笔月度账：50 个条目和 20 个小组话题

用一个具体的需求算钱。假设一个出版社的新媒体团队每周看 50 个图书条目的热门短评（每个条目每周调一次、每次 100 条），每周跟 20 个小组话题（每次带回最多 100 条回复），每月开头搜一遍这 50 个条目拿链接，每月每个条目再读 5 篇长评。按 4 周计：

| 项目 | 次数或条数 | 单价（美元） | 小计（美元） |
| --- | --- | --- | --- |
| `douban/comments`，每周 50 次 | 200 次 | 0.001389 / 次 | 0.2778 |
| `douban/group_topic`，每周 20 次 | 80 次 | 0.001389 / 次 | 0.1111 |
| `douban/search`，每月 50 次 | 50 次 | 0.001389 / 次 | 0.0695 |
| `douban/reviews`，每个条目 5 篇 | 250 条 | 0.024 / 条 | 6.0000 |
| 合计 |  |  | 6.4584 |

一个月 6.46 美元，其中长评占 6.00 美元，约 93%。如果不读长评，同样的短评和小组跟踪一个月只要 0.46 美元。预算的大头取决于要不要长评全文，短评和小组话题几乎可以忽略。同样的量用开源脚本，接口费是 0，但每周 200 次条目详情页请求按 jackjin1997/douban-mcp 的说明大多要 Cookie，账号和 IP 的风险在你这边；走豆瓣书面授权，价格和条件要谈。

如果同一个团队还看其他平台，同一把 Key 可以调[知乎数据接口](/zhihu-api)、[B 站数据接口](/bilibili-api)和[抖音数据接口](/douyin-api)，计费方式相同；豆瓣全部能力和在线试调在[豆瓣数据接口](/douban-api)页面。

## 什么时候别的方案更合适

我们的接口有明确的空白，下面几种情况换别的路更合适。

要豆瓣评分和评分人数。本轮的 `douban/search` 返回里评分字段为空，我们的豆瓣目录里也没有单独的「条目详情」能力。《法律声明》第二节第 2 条把「在商业产品中展示豆瓣评分」列在需要书面许可的用途里；要长期、大量使用评分，可以直接联系豆瓣询问授权。

要最新短评、按时间排序的评论流。`douban/comments` 只有条目链接一个参数，返回的是热门短评，最新一条停在 2024 年。做新片口碑日报，这项能力的数据跟不上。

要用户层面的数据，例如某个人的想看、看过列表。我们的目录没有这类能力，豆瓣 robots.txt 也对 `/people/*/collect`、`/people/*/wish` 等路径写了 Disallow；涉及个人信息时还要考虑[《个人信息保护法》](https://www.stats.gov.cn/gk/tjfg/xgfxfg/202503/t20250310_1958923.html)。只导出自己账号的记录，用前面提到的个人备份工具就行。

要影视条目的短评，并且马上要。本轮影视条目三次短评请求都是空结果、没扣费；影视口碑可以先用小组话题补。

量很小、只给自己用。一个月查几十本书，开源工具或者手工复制就够了，没有必要接任何付费接口。

## 拿数据前要看的几份原文

和豆瓣数据有关的规则分两层：豆瓣自己的协议和声明，以及适用于所有网络数据的法律。我们不做法律判断，下面只列原文和日期，方便你或你的法务去读。

| 文件 | 发布或施行 | 和豆瓣数据相关的内容 |
| --- | --- | --- |
| [豆瓣《法律声明》](https://www.douban.com/about/legal) | 2026-11-21 读取 | 未经书面许可不得商业使用豆瓣网内容，含评分、评论、数据统计、舆情监测、AI 训练；授权联系 bd-team@douban.com |
| [豆瓣《使用协议》](https://www.douban.com/about/agreement) | 2025-05-27 公布的修订版 | 第 9.6 条禁止干扰、破解网络服务和为此提供工具 |
| [豆瓣 robots.txt](https://www.douban.com/robots.txt) | 2026-11-21 读取 | 对所有爬虫 Disallow 29 条，含搜索和个人收藏页 |
| [《反不正当竞争法》2025 年修订](https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html) | 2025-10-15 施行 | 第十三条第三款：不得以欺诈、胁迫、避开或破坏技术管理措施等方式获取、使用他人合法持有的数据 |
| [最高法指导性案例 262 号](https://www.court.gov.cn/fabu/xiangqing/474451.html) | 2025-08-28 发布 | 未经许可抓取搬运平台数据集合、实质性替代平台服务，可认定为不正当竞争 |
| [《网络数据安全管理条例》](https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml) | 2025-01-01 施行 | 网络数据处理活动的一般规则 |
| [《个人信息保护法》](https://www.stats.gov.cn/gk/tjfg/xgfxfg/202503/t20250310_1958923.html) | 2021-11-01 施行 | 处理昵称、头像、主页等个人信息的规则 |

指导性案例 262 号写的基本案情是：2018 年 11 月到 2019 年 5 月，被告应用上有 50,392 个短视频和原平台一致，涉及 19,079 个用户昵称和头像（其中 15,924 个与原平台相同），另有 127 处评论的内容、顺序和标点都和原平台相同。原告请求赔偿 4,000 万元，北京市海淀区人民法院 2020 年 12 月判赔 500 万元，北京知识产权法院 2023 年 3 月二审维持。判决理由里的说法是「实质性替代」：用户不用原平台、在被告平台上也能看到相同内容。案例原文还写了，2025 年 10 月 15 日修订后的《反不正当竞争法》施行以后，法院对相关行为适用第十三条第三款认定。最高法 2025 年发布的反不正当竞争典型案例里也有数据爬取类案件，[证监会北京监管局转载的全文](https://www.csrc.gov.cn/beijing/c105536/c7657880/content.shtml)写的典型意义是「有效遏制了非法爬取海量数据」。

案例里法院认定「实质性替代」的事实，是被告应用上展示了与原平台相同的大量内容，用户不用原平台也能看到。你的用法和案例情形是否相近，请自己或法务对照原文判断，我们不下结论。我们的接口返回里带作者名、作者主页链接和头像，入库时建议只留分析需要的字段，昵称和头像能不存就不存。如果豆瓣用户认为自己的内容被搬运，豆瓣有[侵权投诉指引](https://help.douban.com/complaint/)，被投诉的一方要能说清数据从哪来、存了什么。

## 最近 60 天的变化

豆瓣相关的开源工具在最近两个月集中出现了一批 MCP 项目，方向一致，都是让 AI 助手能直接查书影音。

2026-10-09 创建、10-22 最后提交的 AaronZ345/douban-cli 把书影查询、豆列、评分和短评管理做成命令行，同时提供 MCP 接口，写入类工具默认 `dryRun=true`。对读者的意义：想让 AI 帮你批量整理自己的豆瓣标记，已经有现成工具，但写操作要用你的账号。

2026-10-25 创建的 BugenZhao/douban-mcp 走豆瓣 App 接口，要用账号密码登录、可能要短信验证。对读者的意义：App 接口的数据最全，代价是登录态和签名常量都在你的机器上，账号风险自担。

2026-11-14 创建、11-17 最后提交的 openplayx/mcp-douban 把豆瓣影视数据做成 HTTP 接口和 MCP 服务，说明里列了被豆瓣拒绝时的错误码。对读者的意义：自建服务也能跑起来，但你要自己处理 IP 被封和接口变化。

2026-11-17，jackjin1997/douban-mcp 的最新提交仍然写着详情页必须配 Cookie，App 接口通道因为签名要求已移除。对读者的意义：同一时期，不用账号能稳定拿到的只有聚合页数据，详情页、评论这一层要么用账号，要么用别人维护的接口。

协议层面，[MCP 2026-07-28 版规范](https://modelcontextprotocol.io/specification/2026-07-28)把核心协议改成无状态请求，[项目路线图](https://modelcontextprotocol.io/development/roadmap)列了 Tasks 等扩展。上面几个本机项目里，详情页、写操作或通用搜索多要在你的电脑上保存 Cookie、登录会话或账号密码；远程 MCP 在客户端配置里填地址和 API Key，不涉及豆瓣账号。

学术界对豆瓣数据的需求一直在。2026 年 7 月发表的[豆瓣电影评论多模态数据集论文](https://doi.org/10.1007/s00530-026-02499-0)构建了包含海报、元数据和评分的豆瓣电影评论数据集；2025 年的[评论可读性与票房研究](https://doi.org/10.1016/j.entcom.2024.100911)用的是豆瓣短评；[中国电影社交平台营销研究](https://doi.org/10.2139/ssrn.5126807)整理了 957 部电影的豆瓣和猫眼数据。研究用途通常量大、时间跨度长，热门短评偏向老评论这一点（100 条里 67 条在 2011–2015 年）会直接影响研究结论，抽样前要先看清楚返回的是哪一类评论。

## 常见问题

### 豆瓣有官方 api 吗？

有过，现在不对个人开放。2026-11-21 新加坡时间 00:16 匿名请求 api.douban.com 的电影接口返回 403 和 `invalid_apikey`，并让联系 bd-team@douban.com 取得授权；developers.douban.com 在互联网档案馆的快照记录停在 2018-08-22。V2EX 上 2020 年的帖子[《豆瓣 API 彻底不让用了？》](https://v2ex.com/t/699393)记录了旧 key 整批失效那一天。

### 豆瓣 api 哪家好？

看用途。商业展示评分走向豆瓣申请的书面授权；个人书库补元数据用 calibre-douban 这类专用插件；要批量的热门短评和小组讨论、不想维护登录态，用按次付费接口。比较按次付费服务时，核每次实际返回条数、长评是否按条计费、空结果扣不扣钱、要不要你的 Cookie。我们的数据：短评每次 100 条 0.001389 美元，长评每条 0.024 美元，空结果和错误请求 0 元。

### 有没有现成的豆瓣接口？

有三类现成的：豆瓣书面授权的接口（要谈）、GitHub 开源项目（我们核了 18 个，2026 年还在更新的 5 个多是 MCP 小工具）、按次付费接口（EveryInfra 目录里豆瓣有 4 项能力，本轮图书短评、长评、小组话题和搜索都取到了数据）。V2EX 2019 年的帖子[《截止 2019 年 10 月，豆瓣图书相关的 API 都不能用了吗？》](https://hk.v2ex.com/t/609234)里，楼主问的就是「有更好的方法或者服务推荐吗」。

### 豆瓣 api 推荐用哪个做批量短评分析？

按本轮实测，`douban/comments` 一次传 `limit=100` 返回 100 条，每千条 0.0139 美元；注意它返回的是按星级分档的热门短评，1 到 5 星各 15～24 条，最新一条停在 2024 年，适合分析好评差评的理由，不适合估平均分或跟踪新片。

### 豆瓣api key 还能申请吗？

公开渠道申请不到。旧的开发者站已经无响应，我们 2026-11-21 核对的公开文档里没有自助申请入口；网上流传的共享 key 在 2020 年 8 月已经整批失效（见 V2EX 帖子）。需要正式授权，按《法律声明》联系 bd-team@douban.com。

### 豆瓣 api github 上的项目能直接用吗？

能用的有，但要分辨。星多的大多停更，18 个里 7 个没有许可证、2 个已归档；2026 年在更新的 MCP 项目多数要 Cookie 或登录，例如 jackjin1997/douban-mcp 写明详情页必须配 `DOUBAN_COOKIE`。

### 豆瓣书籍 api 能按 ISBN 查吗？

我们的 `douban/search` 按书名、片名等关键词搜条目，目录说明里没有写 ISBN，本轮也没有测 ISBN，不能保证可用。按 ISBN 查书目信息，可以先试 GitHub 上专门做 ISBN 查询的开源项目，或者走出版物数据库。上面那个 2019 年的 V2EX 帖子里，楼主也提到「ISBN 都不能查询」。

### 豆瓣 api 代理是什么，还能用吗？

「豆瓣 api 代理」指的是一类自建服务：在自己的服务器上抓豆瓣页面，再按旧 API 的格式返回，给 Calibre、Jellyfin 这类软件用。wanglin2/douban_api 的说明写的就是官方接口关闭后自己搭一个替代服务，cxfksword/douban-api-rs 专门给 Jellyfin 刮削影片，后者已在 2022-10-21 后归档。这类服务能不能用，取决于作者是否还在跟豆瓣的页面改版，以及你的服务器 IP 有没有被限制。

## 上手步骤

第一步，在 [EveryInfra 控制台](/docs#quickstart)注册并拿到 API Key，新账号有试用额度。第二步，用目录确认参数，目录不用 Key：

```bash
curl -s "https://api.everyinfra.com/api/v1/social/catalog?platform=douban"
```

第三步，先搜条目拿链接，再取短评。下面是本轮实际用过的请求体，Key 放在环境变量里：

```bash
curl -s -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douban","action":"search","params":{"keyword":"三体","type":"book"}}'

curl -s -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douban","action":"comments","params":{"url":"https://book.douban.com/subject/2567698/","limit":100}}'
```

`douban/comments` 每条返回的字段和目录 `response_fields` 一一对应：`id` 是短评编号，`subject_id`、`subject_name`、`subject_type` 是条目编号、名称和类型（book、movie、music），`text` 是正文，`rating` 是星级、`rating_scale` 是满分刻度、`rating_label` 是「力荐」「推荐」这类档位文字，`vote_count` 是被点「有用」的次数，`posted_at` 是发布时间（带时区），`author_name`、`author_url`、`author_avatar_url` 是作者昵称、主页和头像，`platform` 固定为 douban。`douban/reviews` 多出 `url`、`title` 和 `reply_count`，`douban/group_topic` 多出 `group_id`、`group_name`、`group_url` 和嵌套的 `replies` 列表。

返回的 `billing.charged_usd` 是这次实际扣的钱，空结果时为 0，`billing.reason` 写 `empty_result_refunded`。小组话题入库前按 `id` 去重：

```text
import json
data = json.load(open("group_topic.json"))
topic = data["results"][0]
seen, replies = set(), []
for r in topic["replies"]:
    if r["id"] not in seen:
        seen.add(r["id"])
        replies.append({k: r.get(k) for k in ("id", "text", "vote_count", "posted_at")})
print(topic["reply_count"], len(topic["replies"]), len(replies))
```

第四步，接进 AI 工具。远程 MCP 地址是 `https://api.everyinfra.com/mcp`，配置方法见 [MCP 服务说明](/mcp-server)和[远程 MCP 接入指南](/build/remote-mcp-setup)，下面是一份通用的客户端配置示例：

```text
{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${EVERYINFRA_API_KEY}" }
    }
  }
}
```

2026-11-21 新加坡时间 00:26 我们对这个地址做的 `tools/list` 返回 12 个工具，查豆瓣用 `everyinfra_call_api`，参数和上面的请求体一样。价格细节见[价格页](/pricing)。同系列的选型文还有[小红书 API 官方和第三方怎么选](/blog/xiaohongshu-api-official-vs-third-party)；想看完整的 Python 抓取流程，可以参考[抖音 API 的 Python 教程](/blog/douyin-api-python)，换成豆瓣的能力名即可。

## 参考资料

1. 豆瓣 robots.txt，豆瓣，2026-11-21 读取，<https://www.douban.com/robots.txt>
1. 豆瓣电影 robots.txt，豆瓣，2026-11-21 读取，<https://movie.douban.com/robots.txt>
1. 法律声明，豆瓣，2026-11-21 读取，<https://www.douban.com/about/legal>
1. 豆瓣使用协议（2025 年 5 月 27 日修订版），豆瓣，<https://www.douban.com/about/agreement>
1. 豆瓣侵权投诉指引，豆瓣，<https://help.douban.com/complaint/>
1. api.douban.com 电影 Top250 接口返回，豆瓣，2026-11-21 请求，<https://api.douban.com/v2/movie/top250>
1. api.douban.com 图书接口返回，豆瓣，2026-11-21 请求，<https://api.douban.com/v2/book/1220562>
1. 豆瓣开发者服务（站点），豆瓣，2026-11-21 无响应，<https://developers.douban.com/>
1. 豆瓣开发者服务首页存档，互联网档案馆，2018-06-26，<https://web.archive.org/web/20180626151022/https://developers.douban.com/>
1. developers.douban.com 快照索引（CDX），互联网档案馆，2026-11-21 查询，<https://web.archive.org/cdx/search/cdx?url=developers.douban.com&output=json&fl=timestamp,statuscode&collapse=timestamp:6>
1. douban/douban-client，GitHub，<https://github.com/douban/douban-client>
1. lanbing510/DouBanSpider，GitHub，<https://github.com/lanbing510/DouBanSpider>
1. fugary/calibre-douban，GitHub，<https://github.com/fugary/calibre-douban>
1. iphysresearch/TOP250movie_douban，GitHub，<https://github.com/iphysresearch/TOP250movie_douban>
1. baabaaox/ScrapyDouban，GitHub，<https://github.com/baabaaox/ScrapyDouban>
1. fugary/calibre-web-douban-api，GitHub，<https://github.com/fugary/calibre-web-douban-api>
1. JimSunJing/douban_crawler，GitHub，<https://github.com/JimSunJing/douban_crawler>
1. kxy000/doubanapi，GitHub，<https://github.com/kxy000/doubanapi>
1. wanglin2/douban_api，GitHub，<https://github.com/wanglin2/douban_api>
1. kaito-kidd/douban-group-spider，GitHub，<https://github.com/kaito-kidd/douban-group-spider>
1. cxfksword/douban-api-rs，GitHub，<https://github.com/cxfksword/douban-api-rs>
1. acdzh/douban-book-api，GitHub，<https://github.com/acdzh/douban-book-api>
1. AaronZ345/douban-cli，GitHub，<https://github.com/AaronZ345/douban-cli>
1. jackjin1997/douban-mcp，GitHub，<https://github.com/jackjin1997/douban-mcp>
1. moonlin1213/cove-douban-mcp，GitHub，<https://github.com/moonlin1213/cove-douban-mcp>
1. yoyooyooo/douban-mcp，GitHub，<https://github.com/yoyooyooo/douban-mcp>
1. openplayx/mcp-douban，GitHub，<https://github.com/openplayx/mcp-douban>
1. BugenZhao/douban-mcp，GitHub，<https://github.com/BugenZhao/douban-mcp>
1. REST API endpoints for search，GitHub Docs，<https://docs.github.com/en/rest/search/search>
1. RFC 9309: Robots Exclusion Protocol，IETF，2022-09，<https://datatracker.ietf.org/doc/html/rfc9309>
1. 豆瓣 API 彻底不让用了？，V2EX，2020-08-18，<https://v2ex.com/t/699393>
1. 截止 2019 年 10 月，豆瓣图书相关的 API 都不能用了吗？，V2EX，2019-10，<https://hk.v2ex.com/t/609234>
1. 豆瓣逃离计划，ulyc 的博客，2022-02-11，<https://ulyc.github.io/2022/02/11/Douban-Escape-Plan/>
1. 指导性案例 262 号：某科技有限公司诉某文化传媒有限公司不正当竞争纠纷案，最高人民法院，2025-08-28，<https://www.court.gov.cn/fabu/xiangqing/474451.html>
1. 中华人民共和国反不正当竞争法（2025 年修订），国家知识产权局转载，<https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html>
1. 网络数据安全管理条例（国务院令第 790 号），生态环境部转载，2024-09-24，<https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml>
1. 中华人民共和国个人信息保护法，国家统计局转载，<https://www.stats.gov.cn/gk/tjfg/xgfxfg/202503/t20250310_1958923.html>
1. 最高人民法院发布 2025 年人民法院反不正当竞争典型案例，证监会北京监管局转载，<https://www.csrc.gov.cn/beijing/c105536/c7657880/content.shtml>
1. Model Context Protocol Specification 2026-07-28，MCP，<https://modelcontextprotocol.io/specification/2026-07-28>
1. MCP Roadmap，MCP，<https://modelcontextprotocol.io/development/roadmap>
1. Fang 等：Linguistic factors in digital entertainment success，Entertainment Computing，2025，<https://doi.org/10.1016/j.entcom.2024.100911>
1. Hua 等：Rating-aware argument generation for movie reviews，Multimedia Systems，2026-07-16，<https://doi.org/10.1007/s00530-026-02499-0>
1. Wu 等：Typical opinions mining based on Douban film comments in animated movies，Entertainment Computing，2021，<https://doi.org/10.1016/j.entcom.2020.100391>
1. Chou、Lin：Sequential film marketing in China，SSRN，2025，<https://doi.org/10.2139/ssrn.5126807>
1. EveryInfra 豆瓣能力目录，EveryInfra，2026-11-21 读取，<https://api.everyinfra.com/api/v1/social/catalog?platform=douban>
1. EveryInfra 远程 MCP，EveryInfra，2026-11-21 读取，<https://api.everyinfra.com/mcp>
1. 使用Python开发豆瓣API，YouTube，2022-08-11，<https://www.youtube.com/watch?v=nrk09RQMfWE>
1. RESTful API简介及调用豆瓣API，YouTube，2019-06-19，<https://www.youtube.com/watch?v=6udBuOr8LXA>
1. 服务器端通过 request 向豆瓣 api 请求详细数据，YouTube，2021-10-08，<https://www.youtube.com/watch?v=lJHhSeipDgU>
1. 电影【千里江山图】剧情能否超过【悬崖之上】？，豆瓣小组，2026-11-12，<https://www.douban.com/group/topic/505471405/>
1. 三体（图书条目），豆瓣读书，<https://book.douban.com/subject/2567698/>
1. 肖申克的救赎（电影条目），豆瓣电影，<https://movie.douban.com/subject/1292052/>
1. 千里江山图（剧集条目），豆瓣电影，<https://movie.douban.com/subject/36218470/>
1. 再向上：评《飞行家》（长评页面示例），豆瓣电影，2026-11-11，<https://m.douban.com/movie/review/17895673/>
1. Licensing a repository，GitHub Docs，<https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository>
