豆瓣API

时间：2022-10-26 00:14:42

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

相关文章