社交内容 · 数据 API

豆瓣 API

Q: 豆瓣 API 怎么收费？

$1.39 / 千次，豆瓣 全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次 豆瓣 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Q: 豆瓣 API 一次能返回多少条数据？

豆瓣 有 4 个列表接口，包括 search、reviews、comments、group_topic。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Q: 可以先免费试用 豆瓣 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 豆瓣 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

按书影音类型搜索豆瓣条目，分别读取长评、短评和指定小组话题；短评投票不是评分人数，评论分数与条目评分不混算，也不保证全量讨论。调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始看文档

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

豆瓣能力清单

action	必填参数	可选参数	单次条数	模式	单价	返回字段
search	keyword	search_type, type	默认 20 · 最多 50	同步	$1.39 / 千次	id · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform
reviews	url	—	默认 15 · 最多 50	同步	$1.39 / 千次	id · url · subject_id · subject_name · subject_type · title · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · reply_count · posted_at · platform
comments	url	—	默认 20 · 最多 200	同步	$1.39 / 千次	id · subject_id · subject_name · subject_type · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · vote_count · posted_at · platform
group_topic	url	max_replies	默认 10 · 最多 50	同步	$1.39 / 千次	id · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform

豆瓣每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，切换 action 时，也要按对应接口调整参数。同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用豆瓣关键词搜索 API？

search

使用 platform="douban"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 id、url、title、subject_type、year、director 等 14 个字段。

豆瓣 search 的参数分别是什么意思？

keyword必填: 豆瓣条目名称或主题搜索词，用于发现电影、图书、音乐条目；不是全文搜索长评或小组帖子。
search_type可选: 条目类型只接受 all（全部）、movie（电影）、book（图书）或 music（音乐），省略时默认 all。type 同时存在时优先 type；其他显式值会在公开 API 参数校验阶段返回 422。
查看全部 4 个允许值
allbookmoviemusic
type可选: search_type 的优先输入，取 all / movie / book / music。它筛选条目类型，不是 reviews 长评与 comments 短评的切换，后者由 action 决定。
豆瓣读书官方将打分、书评和短评分开说明；该来源只解释 type=book 时的图书评价对象，不能为电影、音乐或其他 type 值的术语、筛选方式和结果口径背书。官方来源：豆瓣读书：条目评分与书评的参考边界来源核查：2026-09-04
查看全部 4 个允许值
allbookmoviemusic

豆瓣特有返回字段与含义（7）

subject_type: 条目类型（电影/书/音乐）。
year: 年份。
director: 导演。
cast: 主演。
artist: 音乐人。
author: 作者。
cover_url: 封面。

怎么调用豆瓣评价 API？

reviews

使用 platform="douban"、action="reviews" 调用“评价”能力；返回列表，默认 15 条、单次最多 50 条，主要包含 id、url、subject_id、subject_name、subject_type、title 等 16 个字段。

豆瓣 reviews 的参数分别是什么意思？

url必填: reviews / comments 传 movie.douban.com、book.douban.com 或 music.douban.com 的 /subject/<ID>/ 条目链接；group_topic 传 www.douban.com/group/topic/<ID>/。长评、短评和小组回复是不同入口。
豆瓣电影分别说明影评与短评，并明确短评区不展示全部短评，折叠内容的公开可见性也不同。本接口返回的电影评论列表不应被当作完整历史或全体观众意见；此来源不替代图书、音乐各自规则。官方来源：豆瓣电影：长评、短评及可见范围来源核查：2026-09-04

豆瓣特有返回字段与含义（5）

subject_type: 条目类型（电影/书/音乐）。
subject_id: 条目 ID。豆瓣把书影音统称「条目(subject)」。
subject_name: 条目名称。
rating_label: 评分档位文字。
author_avatar_url: 评论者头像。

怎么调用豆瓣评论 API？

comments

使用 platform="douban"、action="comments" 调用“评论”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、subject_id、subject_name、subject_type、text、rating 等 14 个字段。

豆瓣 comments 的参数分别是什么意思？

url必填: reviews / comments 传 movie.douban.com、book.douban.com 或 music.douban.com 的 /subject/<ID>/ 条目链接；group_topic 传 www.douban.com/group/topic/<ID>/。长评、短评和小组回复是不同入口。
豆瓣电影分别说明影评与短评，并明确短评区不展示全部短评，折叠内容的公开可见性也不同。本接口返回的电影评论列表不应被当作完整历史或全体观众意见；此来源不替代图书、音乐各自规则。官方来源：豆瓣电影：长评、短评及可见范围来源核查：2026-09-04

豆瓣特有返回字段与含义（6）

subject_type: 条目类型（电影/书/音乐）。
subject_id: 条目 ID。豆瓣把书影音统称「条目(subject)」。
subject_name: 条目名称。
rating_label: 评分档位文字。
author_avatar_url: 评论者头像。
vote_count: 评分人数。

怎么调用豆瓣小组话题 API？

group_topic

使用 platform="douban"、action="group_topic" 调用“小组话题”能力；返回列表，默认 10 条、单次最多 50 条，主要包含 id、url、title、text、group_id、group_name 等 13 个字段。

豆瓣 group_topic 的参数分别是什么意思？

url必填: reviews / comments 传 movie.douban.com、book.douban.com 或 music.douban.com 的 /subject/<ID>/ 条目链接；group_topic 传 www.douban.com/group/topic/<ID>/。长评、短评和小组回复是不同入口。
豆瓣帮助将加入小组、话题置顶和成员管理列为不同功能，部分操作需要组长或管理员权限。这里只读取具体话题，引用管理说明不表示拥有这些权限，也不提供加入、发帖或管理操作。官方来源：豆瓣小组：话题读取与成员管理不是一回事来源核查：2026-09-04
max_replies可选: group_topic 每个话题最多读取的回复数，默认 20、范围 1–100；越界截取到边界，不能解析时回默认值。不是话题数量，也不保证拿到所有历史回复。

豆瓣特有返回字段与含义（4）

group_id: 小组 ID。
group_name: 小组名。
group_url: 小组链接。
replies: 回复列表。

一次豆瓣 search 调用的全过程：向 POST /api/v1/social 发送 platform="douban"、action="search"，以及必填参数 keyword;返回结构化 JSON，含 id、url、title、subject_type、year 等字段；返回列表，单次最多 50 条，计费 $1.39 / 千次，失败与空结果不计费。

豆瓣原始字段名

EveryInfra 统一字段名

左边是豆瓣数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配；切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

豆瓣的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 8 个字段名只在豆瓣出现。这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

subject_type
director
artist
subject_id
subject_name
group_id
group_name
replies

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。机器可读版：/api/v1/social/fields

id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url: 该记录在原平台上的可访问链接。
title: 标题。平台无标题概念时（如纯文本帖）为 null。
subject_type: 条目类型（电影/书/音乐）。
year: 年份。
director: 导演。
cast: 主演。
author: 作者。
artist: 音乐人。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_count: 参与评分的人数。null 表示不公开，不等于 0。
cover_url: 封面。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
subject_id: 条目 ID。豆瓣把书影音统称「条目(subject)」。
subject_name: 条目名称。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
rating_label: 评分档位文字。
author_name: 作者昵称（显示名）。
author_url: 作者在原平台的主页链接。
author_avatar_url: 评论者头像。
reply_count: 回复数，通常用于评论的子回复。null 表示不公开。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
vote_count: 评分人数。
group_id: 小组 ID。
group_name: 小组名。
group_url: 小组链接。
replies: 回复列表。

请求填写示例

这里使用条目检索词；电影、图书等类型按该接口说明选择。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

douban_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"douban","action":"search","params":{"keyword":"星际穿越"}}'

记录字段预览（非真实响应）

仅展示 search 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json

{
  "id": null,
  "url": null,
  "title": null,
  "subject_type": null,
  "year": null,
  "director": null,
  "cast": null,
  "author": null,
  "artist": null,
  "rating": null,
  "rating_scale": null,
  "rating_count": null,
  "cover_url": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

按豆瓣条目类型发现书、电影与音乐

用 search 找到条目链接，再进入对应长评或短评查询。

查看 search 的 type 参数 →

keyword 是条目名称或主题词；type 可用 all、movie、book、music，默认 all，与 search_type 同时提供时优先 type。这里区分的是条目类型，不是长评与短评，后者分别由 reviews / comments 选择。
subject_type 与 url 用于核对对象，director / cast、author、artist 分别适用于不同条目，不要求每行全部出现。rating / rating_count 是条目评分信息，不是某篇评论的分数或投票数量；搜索结果不能当作全站评论全文检索。

读取豆瓣条目下的长篇影评、书评或乐评

用 reviews 保留长评的标题、正文、作者与原文链接。

查看 reviews 的 url 参数 →

url 填 movie.douban.com、book.douban.com 或 music.douban.com 的 /subject/<ID>/ 条目链接，不填某篇 /review/ 长评链接，也不填小组话题。返回 id / url 定位长评，subject_id / subject_name 则定位被评价的条目。
title 与 text 是长评标题和正文，reply_count 是回复数量，不表示已取得回复列表。单篇 rating 与条目聚合评分不是同一对象，目前其数值刻度仍需核对，保留 rating_label 和原文，不直接跨对象平均；长评展示也不保证包含所有已发表内容。

收集豆瓣条目短评，分清投票与评分人数

用 comments 整理短评文字，不把它当成长评的楼中楼回复。

查看 comments 的 url 参数 →

url 使用书影音 /subject/<ID>/ 条目链接；text、author_url、posted_at 与 subject_id 保留短评和条目的关系。本接口不是读取某篇长评下的回复，也不提供短评排序筛选参数。
vote_count 是这条短评的投票计数，不是条目 rating_count，也不是参与评分的人数；rating / rating_label 对应评论者的评价，数值刻度核对前不与条目分数混算。豆瓣电影帮助说明短评区不会展示全部短评，因此本次列表不能作为全量评价样本。

读取豆瓣小组话题正文与有限回复

用 group_topic 查看一个具体讨论，分别记录话题、小组和回复。

查看 group_topic 的 max_replies 参数 →

url 填 www.douban.com/group/topic/<ID>/，不是小组首页或书影音条目链接。id / url 对应话题，group_id / group_name / group_url 对应所属小组；text 可能带 Markdown 图片链接，展示时仍需按应用安全策略处理。
max_replies 控制每个话题最多读取的回复，默认 20、范围 1–100，不是话题数量。replies 是实际取得的回复数组，reply_count 是话题回复计数，两者不保证相等；此接口没有加入小组、发帖、回复、置顶或成员管理能力，也不保证读取受限讨论。

豆瓣 API 常见问题

豆瓣 API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="douban"、action 和 params。以 search 为例，必填 keyword，可选 search_type、type。这里使用条目检索词；电影、图书等类型按该接口说明选择。豆瓣共 4 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

豆瓣 API 怎么收费？

$1.39 / 千次，豆瓣全部 4 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 719 次豆瓣调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

豆瓣 API 一次能返回多少条数据？

豆瓣有 4 个列表接口，包括 search、reviews、comments、group_topic。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

豆瓣 API 返回哪些字段？

当前目录为 search 列出 id、url、title、subject_type、year、director 等 14 个字段名。按全站当前目录统计，8 个字段名只在豆瓣出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「按豆瓣条目类型发现书、电影与音乐」怎样接入豆瓣 API？

用 search 找到条目链接，再进入对应长评或短评查询。 keyword 是条目名称或主题词；type 可用 all、movie、book、music，默认 all，与 search_type 同时提供时优先 type。这里区分的是条目类型，不是长评与短评，后者分别由 reviews / comments 选择。 subject_type 与 url 用于核对对象，director / cast、author、artist 分别适用于不同条目，不要求每行全部出现。rating / rating_count 是条目评分信息，不是某篇评论的分数或投票数量；搜索结果不能当作全站评论全文检索。

「读取豆瓣条目下的长篇影评、书评或乐评」怎样接入豆瓣 API？

用 reviews 保留长评的标题、正文、作者与原文链接。 url 填 movie.douban.com、book.douban.com 或 music.douban.com 的 /subject/<ID>/ 条目链接，不填某篇 /review/ 长评链接，也不填小组话题。返回 id / url 定位长评，subject_id / subject_name 则定位被评价的条目。 title 与 text 是长评标题和正文，reply_count 是回复数量，不表示已取得回复列表。单篇 rating 与条目聚合评分不是同一对象，目前其数值刻度仍需核对，保留 rating_label 和原文，不直接跨对象平均；长评展示也不保证包含所有已发表内容。

「收集豆瓣条目短评，分清投票与评分人数」怎样接入豆瓣 API？

用 comments 整理短评文字，不把它当成长评的楼中楼回复。 url 使用书影音 /subject/<ID>/ 条目链接；text、author_url、posted_at 与 subject_id 保留短评和条目的关系。本接口不是读取某篇长评下的回复，也不提供短评排序筛选参数。 vote_count 是这条短评的投票计数，不是条目 rating_count，也不是参与评分的人数；rating / rating_label 对应评论者的评价，数值刻度核对前不与条目分数混算。豆瓣电影帮助说明短评区不会展示全部短评，因此本次列表不能作为全量评价样本。

「读取豆瓣小组话题正文与有限回复」怎样接入豆瓣 API？

用 group_topic 查看一个具体讨论，分别记录话题、小组和回复。 url 填 www.douban.com/group/topic/<ID>/，不是小组首页或书影音条目链接。id / url 对应话题，group_id / group_name / group_url 对应所属小组；text 可能带 Markdown 图片链接，展示时仍需按应用安全策略处理。 max_replies 控制每个话题最多读取的回复，默认 20、范围 1–100，不是话题数量。replies 是实际取得的回复数组，reply_count 是话题回复计数，两者不保证相等；此接口没有加入小组、发帖、回复、置顶或成员管理能力，也不保证读取受限讨论。

可以先免费试用豆瓣 API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择豆瓣的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 4 个能力。无需信用卡。

Behance API B站 API Bluesky API Dailymotion API DeviantArt API Discord API 抖音 API Dribbble API 全部 89 平台 ↗

开始调用豆瓣 API

加微信领 $1 免费额度，先选一个豆瓣接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始

豆瓣 API

豆瓣 能力清单

豆瓣 每个接口分别做什么

怎么调用 豆瓣 关键词搜索 API？