豆瓣API
Api V2 索引
图书Api V2
电影Api V2
音乐Api V2
同城Api V2
广播Api V2
用户Api V2
日记Api V2
相册Api V2
线上活动Api V2
论坛Api V2
回复Api V2
我去Api V2
https://developers.douban.com/wiki/?title=api_v2
搜索图书
GET https://api.douban.com/v2/book/search
参数 | 意义 | 备注 |
q | 查询关键字 | q和tag必传其一 |
tag | 查询的tag | q和tag必传其一 |
start | 取结果的offset | 默认为0 |
count | 取结果的条数 | 默认为20,最大为100 |
返回:返回status=200,
{
"start": 0,
"count": 10,
"total": 30,
"books" : [Book, ]
}
注:对于登录用户,若搜索结果图书在当前用户的图书收藏中,会在对应搜索结果信息中附加当前用户对此书的收藏信息,改部分的 Book 数据结构如下:
{
… (图书信息的其他部分)
"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
}
}
获取图书信息
GET https://api.douban.com/v2/book/:id
返回图书信息,返回status=200
对于授权用户,返回数据中会带有该用户对该图书的收藏信息:
{
… (图书信息的其他部分)
"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://developers.douban.com/wiki/?title=book_v2
电影条目搜索
Resources URI
/v2/movie/search?q={text}
Required Scope
movie_basic_r
Example:
GET https://api.douban.com/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 | - |
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 |
https://developers.douban.com/wiki/?title=movie_v2
获取音乐信息
GET https://api.douban.com/v2/music/:id
返回音乐信息,返回status=200
搜索音乐
GET https://api.douban.com/v2/music/search
参数 | 意义 | 备注 |
q | 查询关键字 | q和tag必传其一 |
tag | 查询的tag | q和tag必传其一 |
start | 取结果的offset | 默认为0 |
count | 取结果的条数 |
返回:返回status=200,
{
"start": 0,
"count": 10,
"total": 30,
"musics" : [Music, ]
}
https://developers.douban.com/wiki/?title=music_v2#get_music_search