豆瓣接口实例

发表于 | 分类于 ， ， | 阅读次数:

豆瓣API
搜索书籍、电影、音乐
GET http://api.douban.com/book/subjects
GET http://api.douban.com/movie/subjects
GET http://api.douban.com/music/subjects

请求参数

参数 意义 备注
q 全文检索的关键词
tag 搜索特定tag
start-index 起始元素
max-results 返回结果的数量
alt 返回数据格式

返回格式

获取书籍信息
如果请求中包含了API认证授权参数，则返回值中包含当前授权用户的对于这本书籍收藏的link。

1
GET http://api.douban.com/book/subject/{subjectID}

也可以通过isbn获得电影的信息

1
GET http://api.douban.com/book/subject/isbn/{isbnID}

例如

1
2
3
GET http://api.douban.com/book/subject/2023013
GET http://api.douban.com/book/subject/isbn/7543639130
GET http://api.douban.com/book/subject/isbn/9787543639133

获取音乐信息
如果请求中包含了API认证授权参数，则返回值中包含当前授权用户的对于这本音乐收藏的link。

1
GET http://api.douban.com/music/subject/{subjectID}

例如

1
GET http://api.douban.com/music/subject/2272292

获取电影信息
如果请求中包含了API认证授权参数，则返回值中包含当前授权用户的对于这本电影收藏的link。

1
GET http://api.douban.com/movie/subject/{subjectID}

也可以通过imdb获得电影的信息

1
GET http://api.douban.com/movie/subject/imdb/{imdbID}

例如

1
2
GET http://api.douban.com/movie/subject/1424406
GET http://api.douban.com/movie/subject/imdb/tt0213338

获取用户信息

1
GET http://api.douban.com/people/{userID}

返回值说明

名称 意义 备注
db:location 用户的长居地 用户可能没有长居地
db:uid 用户在豆瓣上的个人域名
title 用户的名号
content 用户的自我介绍
link rel=”alternate” 用户的豆瓣页面
link rel=”icon” 用户的头像图片链接
link rel=”homepage” 用户的个人主页

例如

1
GET http://api.douban.com/people/ahbei

返回结果为一个Entry，包含用户的各种信息

豆瓣图书开源API：https://developers.douban.com/wiki/?title=book_v2
搜索图书
https://api.douban.com/v2/book/search

参数 意义 备注
q 查询关键字 q和tag必传其一
tag 查询的tag q和tag必传其一
start 取结果的offset 默认为0
count 取结果的条数 默认为20，最大为100

返回：返回status=200,

1
2
3
4
5
6
{
  "start": 0,
  "count": 10,
  "total": 30,
  "books": [Book, ]
}

注：对于登陆用户，若搜索结果图书在当前用户的图书收藏中，会在对应搜索结果信息中附加当前用户对此书的收藏信息，该部分的Book数据结构如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  ...(图书信息的其他部分)
  "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
  }
}

电影API
请求所携带的参数：

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

返回回来的参数：

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 -

简单示例：
请求2条：

1
https://api.douban.com/v2/movie/in_theaters?count=2

从第二条开始请求三条：

1
https://api.douban.com/v2/movie/in_theaters?start=2&count=3