图书
GET https://api.douban.com/v2/book/search
参数 | 意义 | 备注 |
q | 查询关键字 | q和tag必传其一 |
tag | 查询的tag | q和tag必传其一 |
start | 取结果的offset | 默认为0 |
count | 取结果的条数 | 默认为20,最大为100 |
{
"start": 0,
"count": 10,
"total": 30,
"books" : [Book, ]
}
获取图书信息
GET https://api.douban.com/v2/book/:id
对于授权用户,返回数据中会带有该用户对该图书的收藏信息:
{
… (图书信息的其他部分)
"current_user_collection": {
"status":"read",
"rating": {
"max":5,
"value":"5",
"min":0
},
"updated":"2012-11-2012:08:04",
"user_id":"33388491",
"book_id":"6548683",
"id":605519800
}
}
电影
- 豆瓣热映 https://api.douban.com/v2/movie/in_theaters
- 电影top250 http://api.douban.com/v2/movie/top250
- 电影条目检索 http://api.douban.com/v2/movie/search
- 条目详情 http://api.douban.com/v2/movie/subject
参数:id(电影的id,数字类型)
如:电影《神秘巨星》http://api.douban.com/v2/movie/subject/26942674
- Example:
https://api.douban.com/v2/movie/search?q=张艺谋
/v2/movie/search?tag=喜剧
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 | - |
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 |
获取音乐信息
GET https://api.douban.com/v2/music/:id
搜索音乐
GET https://api.douban.com/v2/music/search
https://api.douban.com/v2/music/search?q=张韶涵&count=1
https://api.douban.com/v2/music/1403456
https://api.douban.com/v2/music/search?tag=日韩
参数 | 意义 | 备注 |
q | 查询关键字 | q和tag必传其一 |
tag | 查询的tag | q和tag必传其一 |
start | 取结果的offset | 默认为0 |
count | 取结果的条数 |
{
"start": 0,
"count": 10,
"total": 30,
"musics" : [Music, ]
}
在微信小程序中,是无法访问的,可以使用https://douban.uieee.com来代替https://api.douban.com
或者使用nginx进行代理 nginx代理豆瓣api-解决403
更新(2019-5-28):
最近api经常报错(报错信息):原因是没有添加apikey
{
"msg": "invalid_apikey",
"code": 104,
"request": "GET /v2/movie/coming_soon"
}
解决:
在参数中添加apikey:https://api.douban.com/v2/movie/coming_soon?apikey=0b2bdeda43b5688921839c8ecb20399b