Movie API Doc

说明:

V2版API权限分3类:

-公开(对应Required Scope URI :movie_basic_r, movie_basic_w)- 所有开发者均可申请,审核通过。限定40次请求/分钟。开放基本数据接口,一般的个人爱好者自建网站或应用都会满足。

-高级(对应Required Scope URI :movie_advance_r, movie_advance_w) - 在运行过一段时间之后,如果这个非商业网站、应用的确出众,且价值观符合Douban,无版权问题,又不和豆瓣电影有正面的商业竞争,可以申请高级权限。开放基本上所有的接口。

-商务(对应Required Scope URI :movie_premium_r, movie_premium_w)- 应用于商务合作,不限制次数,开放有限接口。已经商业化网站请使用此接口。 移植到V2之后,只要满足我们的API规定要求(见后),即可开通。

  • 评分需和资料任一项同时显示,并且标注“豆瓣评分”
  • 如使用资料,须在影片资料下增加链接“去豆瓣电影查看详情”,链接指向为相应条目url
  • 影评须单独注明“豆瓣电影”,不可和其他方评论数据混合显示
  • 如果应用包含客户端服务,此客户端不得使用包含“豆瓣“和”豆瓣电影”字样显示在名称及相应logo内
  • 如果应用使用豆瓣资料、评分、影评,则此应用不得采用其他平台方提供的同类型数据,且应用不得自建评分、影评服务

API列表

电影条目

影人条目

搜索

榜单

TODO

  • [ ] 电影条目信息中删除pubdate字段, 含义和mainland_pubdate重复了
  • [ ] nowplaying, coming两个接口会重新设计

电影条目信息


Resources URI

/v2/movie/subject/:id

Required Scope

movie_basic_r

Example:

GET /v2/movie/subject/1764796

Status:

200 OK

Resources Properties:

Property Description Type Basic Advance Premium Default
id 条目id str Y Y Y -
title 中文名 str Y Y Y -
original_title 原名 str Y Y Y ''
aka 又名 array Y Y Y []
alt 条目页URL str Y Y Y -
mobile_url 移动版条目页URL str Y Y Y -
rating 评分,见附录 dict Y Y Y -
ratings_count 评分人数 int Y Y Y 0
wish_count 想看人数 int Y Y Y 0
collect_count 看过人数 int Y Y Y 0
do_count 在看人数,如果是电视剧,默认值为0,如果是电影值为null int Y Y Y 0 / null
images 电影海报图,分别提供288px x 465px(大),96px x 155px(中) 64px x 103px(小)尺寸 dict Y Y Y -
subtype 条目分类, movie或者tv str Y Y Y movie
directors 导演,数据结构为影人的简化描述,见附录 array Y Y Y []
casts 主演,最多可获得4个,数据结构为影人的简化描述,见附录 array Y Y Y []
writers 编剧,数据结构为影人的简化描述,见附录 array N Y Y []
website 官方网站 str N Y Y ''
douban_site 豆瓣小站 str Y Y Y ''
pubdates 如果条目类型是电影则为上映日期,如果是电视剧则为首Ï日期 array N Y Y []
mainland_pubdate 大陆上映日期,如果条目类型是电影则为上映日期,如果是电视剧则为首播日期 str N Y Y ''
pubdate 兼容性数据,未来会去掉,大陆上映日期,如果条目类型是电影则为上映日期,如果是电视剧则为首播日期 str N Y Y ''
year 年代 str Y Y Y ''
languages 语言 array N Y Y []
durations 片长 array N Y Y []
genres 影片类型,最多提供3个 array Y Y Y []
countries 制片国家/地区 array Y Y Y []
summary 简介 str Y Y Y ''
comments_count 短评数量 int Y Y Y 0
reviews_count 影评数量 int Y Y Y 0
seasons_count 总季数(tv only) int Y Y Y 0 / null
current_season 当前季数(tv only) int Y Y Y 0 / null
episodes_count 当前季的集数(tv only) int Y Y Y 0 / null
schedule_url 影讯页URL(movie only) str Y Y Y ''
trailer_urls 预告片URL,对高级用户以上开放,最多开放4个地址 array N Y Y []
photos 电影剧照,前10张,见附录 array N Y Y []
popular_reviews 影评,前10条,影评结构,见附录 array N Y Y []


影人条目信息


Resources URI

/v2/movie/celebrity/:id

Required Scope

movie_basic_r

Example:

GET /v2/movie/celebrity/1054395

Status:

200 OK

Resources Properties:

Property Description Type Basic Advance Premium Default
id 条目id str Y Y N/A -
name 中文名 str Y Y N/A -
name_en 英文名 str Y Y N/A ''
alt 条目页URL str Y Y N/A -
mobile_url 条目移动版URL str Y Y N/A -
avatars 影人头像,分别提供420px x 600px(大),140px x 200px(中) 70px x 100px(小)尺寸 dict Y Y N/A -
summary 简介 str N Y N/A ''
aka 更多中文名 array Y Y N/A []
aka_en 更多英文名 array Y Y N/A []
website 官方网站 str N Y N/A ''
gender 性别 str Y Y N/A ''
birthday 出生日期 str N Y N/A ''
born_place 出生地 str Y Y N/A ''
professions 职业 array N Y N/A []
constellation 星座 str N Y N/A ''
photos 影人剧照,最多10张,见附录 array N Y N/A []
works 影人作品,最多5部,简版电影条目结构,见附录 array Y Y N/A []


电影条目剧照


Resources URI

/v2/movie/subject/:id/photos

Required Scope

movie_advance_r

Example:

GET /v2/movie/subject/1054395/photos

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10
total 总数 int N/A Y Y 0
subject 电影条目,见附录 dict N/A Y Y -
photos 查询结果,见附录 array N/A Y Y -


电影条目影评列表


Resources URI

/v2/movie/subject/:id/reviews

Required Scope

movie_advance_r

Example:

GET /v2/movie/subject/1054395/reviews

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10
total 总数 int N/A Y Y 0
subject 电影条目,见附录 dict N/A Y Y -
reviews 影评列表,见附录 array N/A Y Y -


电影条目短评列表


Resources URI

/v2/movie/subject/:id/comments

Required Scope

movie_advance_r

Example:

GET /v2/movie/subject/1054395/comments

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10
total 总数 int N/A Y Y 0
subject 电影条目,见附录 dict N/A Y Y -
comments 短评列表,见附录 array N/A Y Y -


影人作品


Resources URI

/v2/movie/celebrity/:id/works

Required Scope

movie_advance_r

Example:

GET /v2/movie/celebrity/1054395/works

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 5

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 5
total 总数 int N/A Y Y 0
celebrity 影人条目,见附录 dict N/A Y Y -
works 作品列表,包括作品及对应的角色,见附录 array N/A Y Y -


影人剧照


Resources URI

/v2/movie/celebrity/:id/photos

Required Scope

movie_advance_r

Example:

GET /v2/movie/celebrity/1054395/photos

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int N/A Y Y 0
count count int N/A Y Y 10
total 总数 int N/A Y Y 0
celebrity 影人条目,见附录 dict N/A Y Y -
photos 剧照列表,见附录 array N/A Y Y -


电影条目搜索


Resources URI

/v2/movie/search?q={text}

Required Scope

movie_basic_r

Example:

GET /v2/movie/search?q=张艺谋 GET /v2/movie/search?tag=喜剧

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
q query string str Y Y Y -
tag tag query string str Y Y Y -
start start int Y Y Y 0
count count int Y Y Y 20

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int Y Y Y 0
count count int Y Y Y 20
total 总数, Basic最多只返回20条记录 int Y Y Y 0
query 搜索字符串 str Y Y Y -
tag 搜索标签 str Y Y Y -
subjects 搜索结果列表,见附录 array Y Y Y -


Top250


Resources URI

/v2/movie/top250

Required Scope

movie_basic_r

Example:

GET /v2/movie/top250

Status:

200 OK

Request Properties:

Property Description Type Basic Advance Premium Default
start start int Y Y N/A 0
count count int Y Y N/A 10

Resources Properties:

Property Description Type Basic Advance Premium Default
start start int Y Y N/A 0
count count int Y Y N/A 10
total 总数 int Y Y N/A 0
title 排行榜名称 str Y Y N/A -
subjects 条目列表,见附录 array Y Y N/A -


北美票房榜


Resources URI

/v2/movie/us_box

Required Scope

movie_basic_r

Example:

GET /v2/movie/us_box

Status:

200 OK

Resources Properties:

Property Description Type Basic Advance Premium Default
title 排行榜名称 str Y Y N/A -
date 排行榜日期范围 str Y Y N/A -
subjects usbox条目列表,见附录 array Y Y N/A -


口碑榜


Resources URI

/v2/movie/weekly

Required Scope

movie_advance_r

Example:

GET /v2/movie/weekly

Status:

200 OK

Resources Properties:

Property Description Type Basic Advance Premium Default
title 排行榜名称 str N/A Y N/A -
subjects weekly条目列表,见附录 array N/A Y N/A -


新片榜


Resources URI

/v2/movie/new_movies

Required Scope

movie_advance_r

Example:

GET /v2/movie/new_movies

Status:

200 OK

Resources Properties:

Property Description Type Basic Advance Premium Default
title 排行榜名称 str N/A Y N/A -
subjects 条目列表,见附录 array N/A Y N/A -

正在上映


Resources URI

/v2/movie/nowplaying

Required Scope

movie_premium_r

Example:

GET /v2/movie/nowplaying

Status:

200 OK

{
    "title": "正在上映的电影",
    "total": 39,
    "entries": [<Subject>, ...],
}

Resources Properties:

Name Type Optional Note
city string yes(default: 北京) 中文,如: “北京” 或者数字ID: 108288
start number yes(default: 0) 0
count number yes 50,无法更改

即将上映


Resources URI

/v2/movie/coming

Required Scope

movie_premium_r

Example:

GET /v2/movie/coming

Status:

200 OK

{
    "title": "即将上映的电影",
    "total": 39,
    "entries": [<Subject>, ...],
}

Resources Properties:

Name Type Optional Note
start number yes(default: 0) 0
count number yes(default: 20) max: 100

Appendix


Simple Celebrity Properties


Property Description Type Basic Advance Premium Default
id 影人条目id str Y Y Y -
name 中文名 str Y Y Y -
alt 影人条目URL str Y Y Y -
avatars 影人头像,分别提供420px x 600px(大),140px x 200px(中) 70px x 100px(小)尺寸 dict Y Y Y -

Simple Rating Properties


Property Description Type Basic Advance Premium Default
min 最低评分 int Y Y Y -
max 最高评分 int Y Y Y -
average 评分 float(1) Y Y Y -
stars 评星数 int Y Y Y -


Rating Properties


Property Description Type Basic Advance Premium Default
min 最低评分 int Y Y Y -
max 最高评分 int Y Y Y -
value 评分 int Y Y Y -


Simple Subject Properties


Property Description Type Basic Advance Premium Default
id 条目id str Y Y Y -
title 中文名 str Y Y Y -
original_title 原名 str Y Y Y ''
alt 条目URL float(1) Y Y Y -
images 电影海报图,分别提供288px x 465px(大),96px x 155px(中) 64px x 103px(小)尺寸 dict Y Y Y -
rating 评分,见附录 dict Y Y Y -
pubdates 如果条目类型是电影则为上映日期,如果是电视剧则为首播日期 array N Y Y []
year 年代 str Y Y Y ''
subtype 条目分类, movie或者tv str Y Y Y movie


Photo Properties


Property Description Type Basic Advance Premium Default
id 图片id str N/A Y Y -
subject_id 条目id str N/A Y Y -
alt 图片展示页url str N/A Y Y -
icon 图片地址,icon尺寸 str N/A Y Y -
image 图片地址,image尺寸 str N/A Y Y -
thumb 图片地址,thumb尺寸 str N/A Y Y -
cover 图片地址,cover尺寸 str N/A Y Y -
created_at 发布日期 str N/A Y Y -
desc 图片描述 str N/A Y Y ''
author 上传用户,见附录 dict N/A Y Y -
album_id 相册id str N/A Y Y -
album_title 相册标题 str N/A Y Y -
album_url 相册地址 str N/A Y Y -
next_photo 下一张图片 str N/A Y Y ''
prev_photo 上一张图片 str N/A Y Y ''
position 图片在相册中的位置,按照时间排序 int N/A Y Y 0
comments_count 评论数 int N/A Y Y 0
photos_count 全部剧照数量 int N/A Y Y 0


Simple Photo Properties


Property Description Type Basic Advance Premium Default
id 图片id str N/A Y Y -
alt 图片展示页url str N/A Y Y -
icon 图片地址,icon尺寸 str N/A Y Y -
image 图片地址,image尺寸 str N/A Y Y -
thumb 图片地址,thumb尺寸 str N/A Y Y -
cover 图片地址,cover尺寸 str N/A Y Y -


Review Properties


Property Description Type Basic Advance Premium Default
id 影评id str Y Y Y -
title 影评名 str Y Y Y -
alt 影评url str Y Y Y -
created_at 发布日期 str Y Y Y -
updated_at 更新日期 str Y Y Y -
subject_id 条目id str Y Y Y -
author 上传用户,见附录 dict Y Y Y -
summary 摘要,100字以内 str Y Y Y -
rating 影评评分,见附录 dict Y Y Y -
useful_count 有用数 int Y Y Y 0
useless_count 无用数 int Y Y Y 0
comments_count 评论数 int Y Y Y 0


Simple Review Properties


Property Description Type Basic Advance Premium Default
id 影评id str Y Y Y -
title 影评名 str Y Y Y -
alt 影评url str Y Y Y -
subject_id 条目id str Y Y Y -
author 上传用户,见附录 dict Y Y Y -
rating 影评评分,见附录 dict Y Y Y -
summary 摘要,100字以内 str Y Y Y -


Comment Properties


Property Description Type Basic Advance Premium Default
id 短评id str Y Y Y -
created_at 发布日期 str Y Y Y -
subject_id 条目id str Y Y Y -
author 上传用户,见附录 dict Y Y Y -
content 短评内容,140字以内 str Y Y Y -
rating 短评评分,见附录 dict Y Y Y -
useful_count 有用数 int Y Y Y 0


Simple User Properties


Property Description Type Basic Advance Premium Default
id 用户id str Y Y Y -
name 用户名 str Y Y Y -
uid 用户唯一标识 str Y Y Y -
signature 用户签名 str Y Y Y ''
alt 用户个人主页url str Y Y Y -
avatar 用户头像 str Y Y Y -


Box-Subject Properties


Property Description Type Basic Advance Premium Default
rank 排名 int Y Y Y -
box 票房 int Y Y Y -
new 是否新上映 bool Y Y -
subject 电影条目见附录 dict Y Y Y -


Weekly-Subject Properties


Property Description Type Basic Advance Premium Default
rank 排名 int Y Y Y -
delta 排名改变量 int Y Y Y Y