豆瓣数据采集 API 推荐(2026):三类方案怎么选
豆瓣有官方 API 吗?2026 年实测:官方入口要授权,开源项目多数停更或要 Cookie,按次付费接口短评每千条 0.0139 美元、长评 24 美元。

有现成的豆瓣接口,分三类:豆瓣自己的开放接口(2018 年起不再对个人开放,商用要找豆瓣书面授权)、GitHub 上的开源爬虫和 MCP 小工具(免费,但星多的大多停更,2026 年还在更新的几个多数要 Cookie 或登录)、按次付费的数据接口(不用自己维护,按调用次数付钱)。下面比较的方案里有一家是 EveryInfra 自己的接口,我们是厂商,文中我们这一侧的价格和返回都来自 2026 年 11 月 21 日新加坡时间 00:13 读取的目录和 00:19–00:31 的 17 次真实请求。同在豆瓣,我们按次付费的价格按数据类型能差 1,700 倍:一次调用拿 100 条热门短评只要 0.001389 美元,折合每千条 0.0139 美元;长评按条计费,每千条 24 美元。
豆瓣有官方 API 吗?
豆瓣有过一套完整的开放接口。互联网档案馆保存的 2018 年 6 月 26 日的开发者站首页写着,开发者可以接入豆瓣社区、读书、电影、音乐、同城等产品的内容和基于兴趣的用户关系,页面底部还有「用豆瓣帐号登录」的入口。豆瓣官方的 Python 客户端 douban/douban-client 在说明里写过当时的配额:不需要授权的公开接口可以用 HTTP 调,不带 apikey 时单个 IP 每分钟限 10 次。这个仓库最后一次提交是 2014-06-22,现在已经归档,有 741 颗星。
开放平台什么时候关的,豆瓣没有发过一份我们能找到的正式公告。我们用两份能复核的原始记录来定时间。第一份是互联网档案馆的 CDX 查询接口:按月去重后,developers.douban.com 一共有 44 条快照记录,第一条是 2012-08-05;状态 200 的最后一条是 2016-12-27,此后到 2018-08-22 的记录都是 301 跳转,2019 年以后一条都没有。第二份是开发者自己的记录:一位作者在 2022 年整理的豆瓣逃离计划列出「2018 年 9 月豆瓣开放平台下线;2019 年 4 月图书 api 无法使用;2020 年各电影 api 无法使用」,V2EX 2020-08-18 的帖子记录了网上流传的几个 apikey 在同一天一起失效,报错是 invalid_credencial2。两份记录的时间对得上:快照记录在 2018 年 8 月底停止,开发者感知到的下线在 2018 年 9 月。
2026 年的现状,我们在 11 月 21 日新加坡时间 00:16 直接请求了两次旧接口。https://api.douban.com/v2/movie/top250 返回 HTTP 403,错误码 104,消息原文是 invalid_apikey, Please contact bd-team;https://api.douban.com/v2/book/1220562 返回 HTTP 400,错误码 131,消息是 apikey_required。接口域名还在应答,只是不接受匿名请求,并且明确让人去找豆瓣商务团队要授权。同一时间 developers.douban.com 的域名能解析到豆瓣的转发服务器,HTTPS 请求却没有任何响应,curl 记为状态 000。

官方这条路现在要什么资质?我们 2026-11-21 核对的公开文档里,没有自助申请 apikey 的页面,也没有价格、配额和审核标准。能找到的唯一入口在豆瓣的《法律声明》第二节第 3 条:「如需使用豆瓣网内容,请联系豆瓣(邮箱:bd-team
| 官方渠道 | 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 | 《法律声明》第二节第 3 条写明的联系方式 | 视协议而定,公开文档没有写 | 书面授权,条件不公开 |
| 豆瓣 App 内部接口 | 开源项目说明里写要签名和登录(见下一节) | 和 App 看到的一样 | 签名常量、账号、短信验证 |
《法律声明》第二节第 2 条还列了一份需要书面许可的用途清单,范围很宽:直接或加工后作为数据产品销售,在商业产品中展示豆瓣评分和用户评论,用于大语言模型训练,用于数据统计、分析报告、舆情监测、商业营销,以及「侵犯或可能侵犯豆瓣权益的数据采集、网络爬虫」。豆瓣《使用协议》的现行版本是 2025 年 5 月 27 日公布的修订版,第 9.6 条另外禁止干扰和破解网络服务。这两份文件对下面三类方案一视同仁:开源脚本、按次付费接口、你自己写的爬虫,都只解决「技术上拿得到」,解决不了「豆瓣是否许可」。

如果决定走授权这条路,给 bd-team
我们不提供法律意见,只把原文摆出来。《法律声明》第二节第 2 条列出的用途里有「舆情监测」「分析报告」,没有单独写个人读书笔记或课程作业;你的用途落在哪一条,请自行核对条款原文,必要时问法务。
视频教程里教的旧写法还能用吗?
我们用 youtube/search 搜了「豆瓣 API」,取前 3 个相关视频:《使用Python开发豆瓣API》(2022-08-11 上传,26 次播放)、《RESTful API简介及调用豆瓣API》(2019-06-19,124 次)、《服务器端通过 request 向豆瓣 api 请求详细数据》(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 个工具 | 要核 |
| 有没有豆瓣书面许可 | 有(签了协议的话) | 没有 | 没有,要用户自己去取得 | 没有 |
| 维护 | 豆瓣 | 作者个人,多数停更 | 我们 | 各家 |

按次付费接口省掉的是抓取、解析、重试和计费这些工程时间,不替你和豆瓣签协议。
GitHub 上的豆瓣开源项目还能用吗?
我们在 2026-11-21 新加坡时间 00:17 用 GitHub 搜索接口查了 5 组词(douban api、douban spider、douban crawler、豆瓣 爬虫、douban mcp),按星数排序各取前 15 个,去掉只是顺带提到豆瓣的合集仓库,留下 18 个以豆瓣为主的仓库,再逐个读了仓库信息、最近一次提交和说明文件。18 个仓库合计 8,301 颗星。
| 仓库 | 星数 | 最后提交 | 许可证 | 要不要 Cookie 或登录 | 用途 |
|---|---|---|---|---|---|
| lanbing510/DouBanSpider | 2,791 | 2020-04-08 | 未声明 | 说明里没写 | 豆瓣读书爬虫 |
| fugary/calibre-douban | 1,385 | 2025-11-08 | Apache-2.0 | 说明里没写 | Calibre 图书元数据插件 |
| iphysresearch/TOP250movie_douban | 1,032 | 2019-04-12 | BSD-2-Clause | 说明写每个爬虫先登录 | Top250 短评爬取和情感分析 |
| baabaaox/ScrapyDouban | 789 | 2022-01-14 | 未声明 | 说明里没写 | 电影和读书 Scrapy 爬虫 |
| douban/douban-client | 741 | 2014-06-22(已归档) | 未声明 | 要 apikey | 豆瓣官方旧 API 客户端 |
| fugary/calibre-web-douban-api | 464 | 2024-06-09 | Apache-2.0 | 说明里没写 | Calibre-Web 图书元数据 |
| JimSunJing/douban_crawler | 204 | 2022-05-09 | MIT | 说明里没写 | 备份个人豆瓣记录 |
| kxy000/doubanapi | 181 | 2020-05-26 | 未声明 | 无代码 | 旧 API 文档备份 |
| wanglin2/douban_api | 179 | 2022-06-19 | MIT | 说明里没写 | 自建豆瓣 API 服务 |
| kaito-kidd/douban-group-spider | 163 | 2021-01-08 | 未声明 | 说明里没写 | 小组帖子爬虫 |
| cxfksword/douban-api-rs | 148 | 2022-10-21(已归档) | MIT | 可选 Cookie | 给 Jellyfin 刮削影片 |
| acdzh/douban-book-api | 117 | 2023-01-30 | MIT | 说明里没写 | 第三方读书 API |
| AaronZ345/douban-cli | 62 | 2026-10-22 | MIT | 账号操作要登录 | 命令行和 MCP |
| jackjin1997/douban-mcp | 20 | 2026-11-17 | MIT | 详情页要 Cookie | MCP 服务 |
| moonlin1213/cove-douban-mcp | 15 | 2026-08-29 | Apache-2.0 | 用本机 Chrome 的登录会话 | 只读 MCP |
| yoyooyooo/douban-mcp | 9 | 2025-03-23 | 未声明 | 配置里要填 Cookie | MCP 服务 |
| openplayx/mcp-douban | 1 | 2026-11-17 | MIT | 影视接口免登录,通用搜索要登录 | HTTP 接口和 MCP |
| BugenZhao/douban-mcp | 0 | 2026-10-25 | 未声明 | 账号密码登录,可能要短信验证 | MCP,走 App 接口 |
星数和活跃度反着走。星最多的 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 的帮助文档写的是,没有许可证时默认适用版权法,作者没有授予复制、分发和修改的权利;具体怎么适用请自行核对。另有 2 个已经归档,作者不再更新。拿这些代码做内部工具前,先看许可证这一列。
有两类用途已经有专门的项目。要给 Calibre 或 Calibre-Web 的个人书库补豆瓣元数据,fugary 的两个插件就是为这件事写的,calibre-douban 的仓库简介写的是「Douban no longer provides book API」;要把自己的豆瓣标记导出备份,JimSunJing/douban_crawler 和上文提到的逃离计划都是只读自己主页的工具,不需要接口。这两类都是个人数据、个人用途,和批量采集别人的评论是两回事。
开源脚本跑在你自己的机器和网络上,豆瓣的风控面对的是你的 IP 和你的账号。2021 年的一篇动画电影短评研究(Wu 等,Entertainment Computing)在 Google Scholar 收录的摘录里提到豆瓣电影的 IP 限制给数据采集带来了麻烦;V2EX 上 2020 年的讨论里,有人提醒「页面解析的话过于暴露,容易触碰反爬」。豆瓣的 robots.txt 对所有爬虫禁止 /search、/subject_search、/j/、/people/*/collect 等 29 条路径,Crawl-delay: 5 这一行写了但被注释掉了,movie.douban.com 的 robots.txt 和主站逐字节相同。robots.txt 的规则含义见 RFC 9309:它是给爬虫的访问请求,本身不是访问控制。
自己写一个豆瓣爬虫要过哪几关
三类方案之外还有第四条路:自己写。开源仓库的说明把要过的关写得很清楚,我们按出现的先后排一遍。第一关是频率,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 就能读:豆瓣能力目录。2026-11-21 新加坡时间 00:13 读取的精简目录里有 106 个平台、626 项能力,其中 591 项标为可用;豆瓣 4 项都标为可用。
| 能力 | 计费 | 目录写的默认和上限 | 参数 | 目录列出的返回字段数 |
|---|---|---|---|---|
douban/search 书影音条目搜索 | 每次 0.001389 美元 | 默认 20,最多 50 | keyword,type 取 all、movie、book、music | 14 |
douban/comments 短评 | 每次 0.001389 美元 | 默认 20,最多 200 | 条目链接 url | 14 |
douban/reviews 长评 | 每条 0.024 美元 | 默认 15,最多 50 | 条目链接 url | 16 |
douban/group_topic 小组话题和回复 | 每次 0.001389 美元 | 每次 1 个话题,回复默认 20、最多 100 | 话题链接 url,max_replies | 13 |
四个数都按实际返回的行数算。短评 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。长评的入口是条目链接,例如《三体》的图书条目;单篇长评在豆瓣上有自己的页面,比如 2026-11-11 发布的一篇《飞行家》影评,但目录里的 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 |

图书短评默认条数那次返回 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 条没打分。一本书的评分分布通常不会这么均匀,这个结果说明返回的是按星级分档挑出的热门短评,适合看「打一星的人在抱怨什么、打五星的人在夸什么」,不适合拿来算平均分。图书条目页上的豆瓣评分要另外取。
发布时间也印证了「热门」:100 条里 67 条发于 2011 到 2015 年,最新一条是 2024-09-19,2025 年以后的一条都没有。目录里 douban/comments 没有排序参数,拿不到「最新短评」。要跟踪一部新上映电影开分后一周的口碑变化,这项能力不够用,要等它积累热门评论,或者改看小组讨论。
小组话题这一项更贴近「最近在聊什么」。我们取的是电影票房小组 2026-11-12 发的一个话题,讨论一部待上映的电影能不能在剧情上超过另一部谍战片。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 年还没开播的剧集,短评为 0 很正常;《肖申克的救赎》两次都是 0 条,一次 limit=200、一次默认条数。同一时段图书条目的短评正常返回,影视条目的三次短评都是空结果、没扣费。影视口碑可以先用小组话题取;空结果不产生费用,换时段重试也不会多花钱。
字段这一项,长评和小组话题的目录字段每一行都有值,短评 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 是两篇长评。退款怎么对账,见失败退款对账。
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 | 第二节第 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 可以调知乎数据接口、B 站数据接口和抖音数据接口,计费方式相同;豆瓣全部能力和在线试调在豆瓣数据接口页面。
什么时候别的方案更合适
我们的接口有明确的空白,下面几种情况换别的路更合适。
要豆瓣评分和评分人数。本轮的 douban/search 返回里评分字段为空,我们的豆瓣目录里也没有单独的「条目详情」能力。《法律声明》第二节第 2 条把「在商业产品中展示豆瓣评分」列在需要书面许可的用途里;要长期、大量使用评分,可以直接联系豆瓣询问授权。
要最新短评、按时间排序的评论流。douban/comments 只有条目链接一个参数,返回的是热门短评,最新一条停在 2024 年。做新片口碑日报,这项能力的数据跟不上。
要用户层面的数据,例如某个人的想看、看过列表。我们的目录没有这类能力,豆瓣 robots.txt 也对 /people/*/collect、/people/*/wish 等路径写了 Disallow;涉及个人信息时还要考虑《个人信息保护法》。只导出自己账号的记录,用前面提到的个人备份工具就行。
要影视条目的短评,并且马上要。本轮影视条目三次短评请求都是空结果、没扣费;影视口碑可以先用小组话题补。
量很小、只给自己用。一个月查几十本书,开源工具或者手工复制就够了,没有必要接任何付费接口。
拿数据前要看的几份原文
和豆瓣数据有关的规则分两层:豆瓣自己的协议和声明,以及适用于所有网络数据的法律。我们不做法律判断,下面只列原文和日期,方便你或你的法务去读。
| 文件 | 发布或施行 | 和豆瓣数据相关的内容 |
|---|---|---|
| 豆瓣《法律声明》 | 2026-11-21 读取 | 未经书面许可不得商业使用豆瓣网内容,含评分、评论、数据统计、舆情监测、AI 训练;授权联系 bd-team |
| 豆瓣《使用协议》 | 2025-05-27 公布的修订版 | 第 9.6 条禁止干扰、破解网络服务和为此提供工具 |
| 豆瓣 robots.txt | 2026-11-21 读取 | 对所有爬虫 Disallow 29 条,含搜索和个人收藏页 |
| 《反不正当竞争法》2025 年修订 | 2025-10-15 施行 | 第十三条第三款:不得以欺诈、胁迫、避开或破坏技术管理措施等方式获取、使用他人合法持有的数据 |
| 最高法指导性案例 262 号 | 2025-08-28 发布 | 未经许可抓取搬运平台数据集合、实质性替代平台服务,可认定为不正当竞争 |
| 《网络数据安全管理条例》 | 2025-01-01 施行 | 网络数据处理活动的一般规则 |
| 《个人信息保护法》 | 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 年发布的反不正当竞争典型案例里也有数据爬取类案件,证监会北京监管局转载的全文写的典型意义是「有效遏制了非法爬取海量数据」。
案例里法院认定「实质性替代」的事实,是被告应用上展示了与原平台相同的大量内容,用户不用原平台也能看到。你的用法和案例情形是否相近,请自己或法务对照原文判断,我们不下结论。我们的接口返回里带作者名、作者主页链接和头像,入库时建议只留分析需要的字段,昵称和头像能不存就不存。如果豆瓣用户认为自己的内容被搬运,豆瓣有侵权投诉指引,被投诉的一方要能说清数据从哪来、存了什么。
最近 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 版规范把核心协议改成无状态请求,项目路线图列了 Tasks 等扩展。上面几个本机项目里,详情页、写操作或通用搜索多要在你的电脑上保存 Cookie、登录会话或账号密码;远程 MCP 在客户端配置里填地址和 API Key,不涉及豆瓣账号。
学术界对豆瓣数据的需求一直在。2026 年 7 月发表的豆瓣电影评论多模态数据集论文构建了包含海报、元数据和评分的豆瓣电影评论数据集;2025 年的评论可读性与票房研究用的是豆瓣短评;中国电影社交平台营销研究整理了 957 部电影的豆瓣和猫眼数据。研究用途通常量大、时间跨度长,热门短评偏向老评论这一点(100 条里 67 条在 2011–2015 年)会直接影响研究结论,抽样前要先看清楚返回的是哪一类评论。
常见问题
豆瓣有官方 api 吗?
有过,现在不对个人开放。2026-11-21 新加坡时间 00:16 匿名请求 api.douban.com 的电影接口返回 403 和 invalid_apikey,并让联系 bd-team
豆瓣 api 哪家好?
看用途。商业展示评分走向豆瓣申请的书面授权;个人书库补元数据用 calibre-douban 这类专用插件;要批量的热门短评和小组讨论、不想维护登录态,用按次付费接口。比较按次付费服务时,核每次实际返回条数、长评是否按条计费、空结果扣不扣钱、要不要你的 Cookie。我们的数据:短评每次 100 条 0.001389 美元,长评每条 0.024 美元,空结果和错误请求 0 元。
有没有现成的豆瓣接口?
有三类现成的:豆瓣书面授权的接口(要谈)、GitHub 开源项目(我们核了 18 个,2026 年还在更新的 5 个多是 MCP 小工具)、按次付费接口(EveryInfra 目录里豆瓣有 4 项能力,本轮图书短评、长评、小组话题和搜索都取到了数据)。V2EX 2019 年的帖子《截止 2019 年 10 月,豆瓣图书相关的 API 都不能用了吗?》里,楼主问的就是「有更好的方法或者服务推荐吗」。
豆瓣 api 推荐用哪个做批量短评分析?
按本轮实测,douban/comments 一次传 limit=100 返回 100 条,每千条 0.0139 美元;注意它返回的是按星级分档的热门短评,1 到 5 星各 15~24 条,最新一条停在 2024 年,适合分析好评差评的理由,不适合估平均分或跟踪新片。
豆瓣api key 还能申请吗?
公开渠道申请不到。旧的开发者站已经无响应,我们 2026-11-21 核对的公开文档里没有自助申请入口;网上流传的共享 key 在 2020 年 8 月已经整批失效(见 V2EX 帖子)。需要正式授权,按《法律声明》联系 bd-team
豆瓣 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 控制台注册并拿到 API Key,新账号有试用额度。第二步,用目录确认参数,目录不用 Key:
curl -s "https://api.everyinfra.com/api/v1/social/catalog?platform=douban"第三步,先搜条目拿链接,再取短评。下面是本轮实际用过的请求体,Key 放在环境变量里:
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 去重:
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 接入指南,下面是一份通用的客户端配置示例:
{
"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,参数和上面的请求体一样。价格细节见价格页。同系列的选型文还有小红书 API 官方和第三方怎么选;想看完整的 Python 抓取流程,可以参考抖音 API 的 Python 教程,换成豆瓣的能力名即可。
参考资料
- 豆瓣 robots.txt,豆瓣,2026-11-21 读取,<https://www.douban.com/robots.txt>
- 豆瓣电影 robots.txt,豆瓣,2026-11-21 读取,<https://movie.douban.com/robots.txt>
- 法律声明,豆瓣,2026-11-21 读取,<https://www.douban.com/about/legal>
- 豆瓣使用协议(2025 年 5 月 27 日修订版),豆瓣,<https://www.douban.com/about/agreement>
- 豆瓣侵权投诉指引,豆瓣,<https://help.douban.com/complaint/>
- api.douban.com 电影 Top250 接口返回,豆瓣,2026-11-21 请求,<https://api.douban.com/v2/movie/top250>
- api.douban.com 图书接口返回,豆瓣,2026-11-21 请求,<https://api.douban.com/v2/book/1220562>
- 豆瓣开发者服务(站点),豆瓣,2026-11-21 无响应,<https://developers.douban.com/>
- 豆瓣开发者服务首页存档,互联网档案馆,2018-06-26,<https://web.archive.org/web/20180626151022/https://developers.douban.com/>
- 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>
- douban/douban-client,GitHub,<https://github.com/douban/douban-client>
- lanbing510/DouBanSpider,GitHub,<https://github.com/lanbing510/DouBanSpider>
- fugary/calibre-douban,GitHub,<https://github.com/fugary/calibre-douban>
- iphysresearch/TOP250movie_douban,GitHub,<https://github.com/iphysresearch/TOP250movie_douban>
- baabaaox/ScrapyDouban,GitHub,<https://github.com/baabaaox/ScrapyDouban>
- fugary/calibre-web-douban-api,GitHub,<https://github.com/fugary/calibre-web-douban-api>
- JimSunJing/douban_crawler,GitHub,<https://github.com/JimSunJing/douban_crawler>
- kxy000/doubanapi,GitHub,<https://github.com/kxy000/doubanapi>
- wanglin2/douban_api,GitHub,<https://github.com/wanglin2/douban_api>
- kaito-kidd/douban-group-spider,GitHub,<https://github.com/kaito-kidd/douban-group-spider>
- cxfksword/douban-api-rs,GitHub,<https://github.com/cxfksword/douban-api-rs>
- acdzh/douban-book-api,GitHub,<https://github.com/acdzh/douban-book-api>
- AaronZ345/douban-cli,GitHub,<https://github.com/AaronZ345/douban-cli>
- jackjin1997/douban-mcp,GitHub,<https://github.com/jackjin1997/douban-mcp>
- moonlin1213/cove-douban-mcp,GitHub,<https://github.com/moonlin1213/cove-douban-mcp>
- yoyooyooo/douban-mcp,GitHub,<https://github.com/yoyooyooo/douban-mcp>
- openplayx/mcp-douban,GitHub,<https://github.com/openplayx/mcp-douban>
- BugenZhao/douban-mcp,GitHub,<https://github.com/BugenZhao/douban-mcp>
- REST API endpoints for search,GitHub Docs,<https://docs.github.com/en/rest/search/search>
- RFC 9309: Robots Exclusion Protocol,IETF,2022-09,<https://datatracker.ietf.org/doc/html/rfc9309>
- 豆瓣 API 彻底不让用了?,V2EX,2020-08-18,<https://v2ex.com/t/699393>
- 截止 2019 年 10 月,豆瓣图书相关的 API 都不能用了吗?,V2EX,2019-10,<https://hk.v2ex.com/t/609234>
- 豆瓣逃离计划,ulyc 的博客,2022-02-11,<https://ulyc.github.io/2022/02/11/Douban-Escape-Plan/>
- 指导性案例 262 号:某科技有限公司诉某文化传媒有限公司不正当竞争纠纷案,最高人民法院,2025-08-28,<https://www.court.gov.cn/fabu/xiangqing/474451.html>
- 中华人民共和国反不正当竞争法(2025 年修订),国家知识产权局转载,<https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html>
- 网络数据安全管理条例(国务院令第 790 号),生态环境部转载,2024-09-24,<https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml>
- 中华人民共和国个人信息保护法,国家统计局转载,<https://www.stats.gov.cn/gk/tjfg/xgfxfg/202503/t20250310_1958923.html>
- 最高人民法院发布 2025 年人民法院反不正当竞争典型案例,证监会北京监管局转载,<https://www.csrc.gov.cn/beijing/c105536/c7657880/content.shtml>
- Model Context Protocol Specification 2026-07-28,MCP,<https://modelcontextprotocol.io/specification/2026-07-28>
- MCP Roadmap,MCP,<https://modelcontextprotocol.io/development/roadmap>
- Fang 等:Linguistic factors in digital entertainment success,Entertainment Computing,2025,<https://doi.org/10.1016/j.entcom.2024.100911>
- Hua 等:Rating-aware argument generation for movie reviews,Multimedia Systems,2026-07-16,<https://doi.org/10.1007/s00530-026-02499-0>
- Wu 等:Typical opinions mining based on Douban film comments in animated movies,Entertainment Computing,2021,<https://doi.org/10.1016/j.entcom.2020.100391>
- Chou、Lin:Sequential film marketing in China,SSRN,2025,<https://doi.org/10.2139/ssrn.5126807>
- EveryInfra 豆瓣能力目录,EveryInfra,2026-11-21 读取,<https://api.everyinfra.com/api/v1/social/catalog?platform=douban>
- EveryInfra 远程 MCP,EveryInfra,2026-11-21 读取,<https://api.everyinfra.com/mcp>
- 使用Python开发豆瓣API,YouTube,2022-08-11,<https://www.youtube.com/watch?v=nrk09RQMfWE>
- RESTful API简介及调用豆瓣API,YouTube,2019-06-19,<https://www.youtube.com/watch?v=6udBuOr8LXA>
- 服务器端通过 request 向豆瓣 api 请求详细数据,YouTube,2021-10-08,<https://www.youtube.com/watch?v=lJHhSeipDgU>
- 电影【千里江山图】剧情能否超过【悬崖之上】?,豆瓣小组,2026-11-12,<https://www.douban.com/group/topic/505471405/>
- 三体(图书条目),豆瓣读书,<https://book.douban.com/subject/2567698/>
- 肖申克的救赎(电影条目),豆瓣电影,<https://movie.douban.com/subject/1292052/>
- 千里江山图(剧集条目),豆瓣电影,<https://movie.douban.com/subject/36218470/>
- 再向上:评《飞行家》(长评页面示例),豆瓣电影,2026-11-11,<https://m.douban.com/movie/review/17895673/>
- Licensing a repository,GitHub Docs,<https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository>
引用编号 BL-205