豆瓣电影 API

豆瓣电影 Top250 与各城市正在热映

数据来源：豆瓣电影（网页抓取）

返回统一的 JSON 格式 { code, message, cached, stale, updatedAt, data }，支持跨域，免注册每天可免费调用 100 次，注册后每天 10000 次。

豆瓣电影 Top250，每页 25 部

GET /api/douban/top250

请求参数

  • page：页码 1~10，示例 1

返回字段

  • page（number）：当前页码（1~10）
  • pageSize（number）：每页条数，固定为 25
  • totalPages（number）：总页数，固定为 10（共 250 部）
  • list（array）：本页的电影，按排名从前到后
  • list[].rank（number|null）：Top250 排名（1~250）；页面解析不到时为 null
  • list[].id（string|null）：豆瓣电影条目 ID（数字字符串，如 "1292052"）；解析不到条目链接时为 null
  • list[].title（string|null）：中文片名；解析不到时取海报的 alt 文本，仍没有时为 null
  • list[].originalTitle（string|null）：外文原名，如 "The Shawshank Redemption"；只有一个片名（如华语片）时为 null
  • list[].otherTitles（string|null）：其他译名/又名，多个用 " / " 分隔，如 "月黑高飞(港) / 刺激1995(台)"；没有时为 null
  • list[].rating（number|null）：豆瓣评分，满分 10（一位小数，如 9.7）；解析不到时为 null
  • list[].votes（number|null）：评价人数；解析不到时为 null
  • list[].year（number|null）：上映年份（4 位数字，如 1994）；解析不到时为 null
  • list[].region（string|null）：制片国家/地区，多个用空格分隔，如 "中国大陆 中国香港"；解析不到时为 null
  • list[].genres（array）：类型，字符串数组，如 ["犯罪", "剧情"]；解析不到时为空数组
  • list[].crew（string|null）：导演与主演（列表页原文，过长时被豆瓣截断为 "..."），如 "导演: 弗兰克·德拉邦特 Frank Darabont 主演: 蒂姆·罗宾斯 Tim Robbins /..."；没有时为 null
  • list[].poster（string|null）：海报链接（豆瓣列表页的小尺寸竖版海报，路径含 s_ratio_poster，格式为 jpg 或 webp）。豆瓣图片有防盗链，网页中引用需加 referrerpolicy="no-referrer"
  • list[].url（string|null）：豆瓣电影条目页面（https://movie.douban.com/subject/{id}/）；解析不到时为 null
  • list[].quote（string|null）：一句话短评/经典台词，如 "希望让人自由。"；部分电影没有，此时为 null

指定城市正在热映的电影

GET /api/douban/nowplaying

请求参数

  • city：城市拼音，例如 beijing、shanghai、guangzhou，示例 shanghai

返回字段

  • city（string）：城市拼音，即请求的 city 参数
  • list（array）：该城市正在上映的电影（不含"即将上映"），按豆瓣页面顺序
  • list[].id（string|null）：豆瓣电影条目 ID（数字字符串）；页面缺失时为 null
  • list[].title（string|null）：片名；页面缺失时为 null
  • list[].rating（number|null）：豆瓣评分，满分 10（一位小数）；暂无评分（刚上映、评价人数不足）时为 null
  • list[].votes（number|null）：评价人数；页面未提供时为 null
  • list[].year（number|null）：上映年份（如 2026）；页面未提供时为 null
  • list[].duration（string|null）：片长文本，如 "128分钟"；页面未提供时为 null
  • list[].region（string|null）：制片国家/地区，如 "中国大陆"；页面未提供时为 null
  • list[].director（string|null）：导演（页面原文）；页面未提供时为 null
  • list[].actors（array）：主演，字符串数组，如 ["李四", "王五"]；页面未提供时为空数组
  • list[].poster（string|null）：海报链接（豆瓣小尺寸竖版海报，路径含 s_ratio_poster）；豆瓣图片有防盗链，网页中引用需加 referrerpolicy="no-referrer"；页面缺失时为 null
  • list[].url（string|null）：豆瓣电影条目页面（https://movie.douban.com/subject/{id}/）；没有 id 时为 null