豆瓣 · 内容详情

条目详情

传入电影或剧集的链接或 ID,返回标题、年份、评分、类型、导演、主演、地区、语言、上映日期和 IMDb ID。

POST/v1/douban/subject

$0.025每条

1,000 条
≈ $25.00
每取一条最低
$0.018017

只能用充值余额一次返回,没有 cursor

在控制台里试

怎么发

用 POST 带 JSON 请求体,或者用 GET 把同样的参数放进查询串。key 放在 Authorization 头里。

curl -X POST "https://api.silklinedata.com/v1/douban/subject" \
  -H "Authorization: Bearer $SILKLINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":5,"subjects":["1291546"]}'

返回什么

这是 2026-11-09 一次真实请求返回的记录。普通用户的名字、头像和主页链接显示为 <masked>;长文字只在这里截短,接口里是完整的。

200 OK · 取数日期 2026-11-09
{
  "data": [
    {
      "type": "subject",
      "subjectId": "1291546",
      "url": "https://movie.douban.com/subject/1291…",
      "title": "霸王别姬",
      "year": 1993,
      "rating": 9.6,
      "ratingCount": 2464664,
      "genres": [
        "剧情",
        "爱情",
        "同性"
      ],
      "directors": [
        "陈凯歌"
      ],
      "writers": [
        "芦苇",
        "李碧华"
      ],
      "cast": [
        "张国荣",
        "张丰毅",
        "巩俐"
      ],
      "regions": [
        "中国大陆",
        "中国香港"
      ],
      "languages": [
        "汉语普通话"
      ],
      "releaseDates": [
        "1993-07-26(中国大陆)",
        "1993-01-01(中国香港)"
      ],
      "episodes": null,
      "duration": "171分钟/ 155分钟(美国剧场版)",
      "durationMinutes": 171,
      "aliases": [
        "再见,我的妾",
        "Farewell My Concubine",
        "Adieu Ma Concubine"
      ],
      "imdbId": "tt0106332",
      "posterUrl": "<masked>"
    }
  ],
  "cursor": null,
  "meta": {
    "request_id": "req_01JD8Q…",
    "charged_usd": "0.025000",
    "balance_usd": "9.875000",
    "items": 1
  }
}

字段 20

字段类型示例值
typestringsubject
subjectIdstring1291546
urlstringhttps://movie.douban.com/subject/1291546/
titlestring霸王别姬
yearnumber1993
ratingnumber9.6
ratingCountnumber2464664
genresarray["剧情","爱情","同性"]
directorsarray["陈凯歌"]
writersarray["芦苇","李碧华"]
castarray["张国荣","张丰毅","巩俐"]
regionsarray["中国大陆","中国香港"]
languagesarray["汉语普通话"]
releaseDatesarray["1993-07-26(中国大陆)","1993-01-01(中国香港)"]
episodesnullnull
durationstring171分钟/ 155分钟(美国剧场版)
durationMinutesnumber171
aliasesarray["再见,我的妾","Farewell My Concubine","Adieu Ma Concubine"]
imdbIdstringtt0106332
posterUrlstring<masked>

参数 2

参数名类型必填说明示例
limitinteger否返回的记录条数,1 到 100。一次请求返回的条数不会超过这个数。5
subjectsarray是仅用于 comments、subject 和 reviews 模式:豆瓣链接(https://movie.douban.com/subject/<id>/)或电影和剧集的条目 ID(不是影评 ID)。["1291546"]

翻页

这个接口一次请求就返回全部:要更多条就把 limit 调大(最多 100)。cursor 一直是 null。

一次请求花多少

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。

这个接口每条单独取,每取一条的最低收费是 $0.018017。

  • 1 条:最多 $0.025
  • 20 条:最多 $0.50
  • 100 条:最多 $2.50

返回的 meta 里写着这次扣了多少(charged_usd)和还剩多少(balance_usd)。我们这边出错不收费。

常见问题

「条目详情」要传哪些参数?

必填:subjects。另外都可以传 limit(1 到 100)。

一次请求最多返回多少条?

每次请求最多 100 条(limit 1 到 100)。每页最多 1 条,要 100 条时一次请求取 100 页。

能接着往后取吗?

不能。这个接口一次请求就把结果全部返回,回答里的 cursor 是 null。

怎么收费?

每条 subject $0.025。每页最低收费 $0.018017:条数少或没有结果时,每取一页最多收这么多,可能更低。取 100 条最多 $2.50。

请求失败或者没有结果时怎么收费?

按条计费;一次请求条数少或没有结果时,每取一页收费不超过这个接口每页的最低收费,可能更低;我们这边出错或超时不收费。回答里的 meta 写着这次收了多少、余额还剩多少。