豆瓣 API 参考手册

书籍、电影、音乐

获取书籍信息

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

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

也可以通过isbn(支持10位、13位,而且支持在其中带-号的)号获得图书的信息

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

例如

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

返回格式

<?xml version="1.0" encoding="UTF-8"?>
    <entry xmlns="http://www.w3.org/2005/Atom"
        xmlns:gd="http://schemas.google.com/g/2005"
        xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/"
        xmlns:db="http://www.douban.com/xmlns/">
        <category scheme="http://www.douban.com/2007#kind"
            term="http://www.douban.com/2007#book" />
        <db:tag count="15" name="片山恭一" />
        <db:tag count="6" name="小说" />
        <db:tag count="5" name="日本小说" />
        <db:tag count="2" name="日本文学" />
        <db:tag count="2" name="日本" />
        <title>倘若我在彼岸-日本畅销爱情小说</title>
        <author>
            <name>片山恭一</name>
        </author>
        <summary>
            本书由三个看似独立实则相通的凄美的爱情故事组成。主人公是老师,都喜欢某种运动,他们都曾亲身经历过或目睹过接近死神的一瞬间并从中感悟或懂得了生命中的某些东西。
            这是作者在《在世界中心呼唤爱》后的首部爱情小说集。片山恭一,学生时代通读了包括夏目漱石和大江健三郎在内的日本近现代文学全集,同时读了从笛卡尔、莱布尼茨到结构主义的欧洲近现代哲学,也读了马克思。自二十二三岁开始创作小说,《气息》、《世界在你不知道的地方运转》、《别相信约翰·列侬》等均为他的代表作。
        </summary>
        <link rel="self" href="http://api.douban.com/book/subject/2023013" />
        <link rel="collection" href="http://api.douban.com/collection/1234567" /><!-- API认证授权后才包含 -->
        <link rel="alternate" href="http://book.douban.com/subject/2023013/" />
        <link rel="image" href="http://t.douban.com/spic/s2328836.jpg" />
        <db:attribute name="isbn10">7543639130</db:attribute>
        <db:attribute name="isbn13">9787543639133</db:attribute>
        <db:attribute name="pages">193</db:attribute>
        <db:attribute name="tranlator">张兴</db:attribute>
        <db:attribute name="price">14</db:attribute>
        <db:attribute name="author">片山恭一</db:attribute>
        <db:attribute name="publisher">青岛出版社</db:attribute>
        <db:attribute name="binding">平装</db:attribute>
        <db:attribute name="author-intro">
            片山恭一,1959年生于日本爱媛县,九州大学农学系农业经济学专业毕业。学生时代通读了包括夏目漱石和大江健三郎在内的日本近现代文学全集,同时读了从笛卡尔、莱布尼茨到结构主义的欧洲近现代哲学。也读了马克思。学士论文写的是马克思,硕士论文写的是恩格斯。二十二三岁开始创作小说。代表作有《在世界中心呼唤爱》、《世界在你不知道的地方运转》、《满月之夜白鲸现》、《空镜头》以及新作《倘若我在彼岸》《雨天的海豚们》、《最后盛开的花》等。
        </db:attribute>
        <id>http://api.douban.com/book/subject/2023013</id>
        <gd:rating min="1" numRaters="12" average="4.00" max="5" />
    </entry>

获取电影信息

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

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

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

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

例如

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

返回格式

<?xml version="1.0" encoding="UTF-8"?>
    <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:db="http://www.douban.com/xmlns/">
        <category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#movie"/>
        <db:tag count="286" name="动画"/>
        <db:tag count="267" name="渡边信一郎"/>
        <db:tag count="183" name="日本"/>
        <db:tag count="173" name="cowboy"/>
        <db:tag count="109" name="动漫"/>
        <title>Cowboy Bebop</title>
        <author>
            <name>渡边信一郎</name>
        </author>
        <summary>友情、爱情、廉价道德观,这些都放在一边,享受着朝不保夕的自由人生,以自己的利益为绝对优先的——赏金猎人们,在剧中被称为COWBOY。
    日本动画中一贯会以某个基地、飞船、要塞什么的把故事中的重要人物塞在一起,然后以“大家好好相处吧!”的形式让情节进行下去,这次的场景设定当然就是这般的BEBOP号了,而其成员包括那条腿短短的狗EIN,都是一群任性到让人血脉逆流的生物。
    你有过过去吗?这似乎是一个极其愚蠢的问题。没有过去哪有现在!然而你还记得你的过去吗?每一个人都有他的过去,然而并不是每一个人都那么珍惜过去。过去对你来说意味着什么:过眼烟云、无足挂齿;还是弥足珍贵?</summary>
        <link rel="self" href="http://api.douban.com/movie/subject/1424406"/>
        <link rel="collection" href="http://api.douban.com/collection/1234567" /><!-- API认证授权后才包含 -->
        <link rel="alternate" href="http://movie.douban.com/subject/1424406/"/>
        <link rel="image" href="http://t.douban.com/spic/s2351152.jpg"/>
        <db:attribute name="year">1998</db:attribute>
        <db:attribute name="director">渡边信一郎</db:attribute>
        <db:attribute name="language">日语</db:attribute>
        <db:attribute name="site">http://www.cowboybebop.org/</db:attribute>
        <db:attribute name="imdb">http://www.imdb.com/title/tt0213338/</db:attribute>
        <db:attribute name="country">Japan</db:attribute>
        <db:attribute name="cast">山寺宏一</db:attribute>
        <db:attribute name="cast">石塚运昇</db:attribute>
        <db:attribute name="cast">林原惠</db:attribute>
        <id>http://api.douban.com/movie/subject/1424406</id>
        <gd:rating min="1" numRaters="1187" average="4.72" max="5"/>
    </entry>

获取音乐信息

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

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

例如

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

返回格式

<?xml version="1.0" encoding="UTF-8"?>
    <entry xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:db="http://www.douban.com/xmlns/">
        <category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#music"/>
        <db:tag count="4394" name="苏打绿"/>
        <db:tag count="2299" name="无与伦比的美丽"/>
        <db:tag count="1300" name="台湾"/>
        <db:tag count="915" name="独立音乐"/>
        <db:tag count="838" name="indie"/>
        <title>无与伦比的美丽</title>
        <author>
            <name>苏打绿</name>
        </author>
        <summary>从第一张同名专辑的学生气息,到第二张专辑《小宇宙》中对社会的初试窥探,《无与伦比的美丽 》表达的是一种更为深刻的想像境地∶从游乐的心情出发,仿佛身处花园之中,以狂想面对各种情感的时候,在真实城市中便仍能简单生活,直到找到相信的力量。
    旋律刻意的铺陈使曲目不曾间断,听觉的空隙仅抽象地由音乐呈现,这是一张完整的专辑,不是十首歌的集锦。苏打绿带来的新作品《无与伦比的美丽》,展露出有别以往的风采。除了苏打绿作为标志的民谣摇滚风格之外,这张专辑加进了独特的管弦编曲,在流行与古典之间,苏打绿完成最优美的滑行。</summary>
        <link rel="self" href="http://api.douban.com/music/subject/2272292"/>
        <link rel="collection" href="http://api.douban.com/collection/1234567" /><!-- API认证授权后才包含 -->
        <link rel="alternate" href="http://music.douban.com/subject/2272292/"/>
        <link rel="image" href="http://t.douban.com/spic/s2757483.jpg"/>
        <db:attribute name="ean">tu130639</db:attribute>
        <db:attribute name="pubdate">2007-11-02</db:attribute>
        <db:attribute name="singer">苏打绿</db:attribute>
        <db:attribute name="publisher">林暐哲音乐社</db:attribute>
        <id>http://api.douban.com/music/subject/2272292</id>
        <gd:rating min="1" numRaters="4161" average="4.16" max="5"/>
    </entry>

搜索书籍、电影、音乐

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 返回结果的数量

例如

GET http://api.douban.com/movie/subjects?tag=cowboy&start-index=1&max-results=2

返回格式

<?xml version="1.0" encoding="UTF-8"?>
    <feed xmlns="http://www.w3.org/2005/Atom" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:db="http://www.douban.com/xmlns/">
        <title>带有标签 cowboy 的条目</title>
        <opensearch:totalResults>246</opensearch:totalResults>
        <opensearch:startIndex>1</opensearch:startIndex>
        <entry>
            <category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#movie"/>
            <author>
                <name>渡边信一郎</name>
            </author>
            <title>Cowboy Bebop</title>
            <summary>友情、爱情、廉价道德观,这些都放在一边,享受着朝不保夕的自由人生,以自己的利益为绝对优先的——赏金猎人们,在剧中被称为COWBOY。
    日本动画中一贯会以某 ...</summary>
            <link rel="self" href="http://api.douban.com/movie/subject/1424406"/>
            <link rel="alternate" href="http://movie.douban.com/subject/1424406/"/>
            <link rel="image" href="http://t.douban.com/spic/s2351152.jpg"/>
            <db:attribute name="year">1998</db:attribute>
            <db:attribute name="language">日语</db:attribute>
            <db:attribute name="site">http://www.cowboybebop.org/</db:attribute>
            <db:attribute name="imdb">http://www.imdb.com/title/tt0213338/</db:attribute>
            <db:attribute name="country">Japan</db:attribute>
            <db:attribute name="cast">山寺宏一</db:attribute>
            <db:attribute name="cast">石塚运昇</db:attribute>
            <db:attribute name="cast">林原惠</db:attribute>
            <id>http://api.douban.com/movie/subject/1424406</id>
        </entry>
        <entry>
            <category scheme="http://www.douban.com/2007#kind" term="http://www.douban.com/2007#movie"/>
            <author>
                <name>渡边信一郎 (Shinichirô Watanabe)</name>
            </author>
            <title>Cowboy Bebop: Knockin' on Heaven's Door</title>
            <summary>地点是火星,时间是2071年的万圣节前夕,一群歹徒在一号公路上炸毁一辆油罐车,并释出一种致命病毒。有关单位担心他们会发动一波更致命的生化战攻击,所以提出钜额奖金 ...</summary>
            <link rel="self" href="http://api.douban.com/movie/subject/1307031"/>
            <link rel="alternate" href="http://movie.douban.com/subject/1307031/"/>
            <link rel="image" href="http://t.douban.com/spic/s1318036.jpg"/>
            <db:attribute name="site">http://www.sonypictures.com/cthe/cowboybebop/</db:attribute>
            <db:attribute name="year">2001</db:attribute>
            <db:attribute name="language">Japanese</db:attribute>
            <db:attribute name="imdb">http://www.imdb.com/title/tt0275277/</db:attribute>
            <db:attribute name="country">Japan</db:attribute>
            <id>http://api.douban.com/movie/subject/1307031</id>
        </entry>
        <opensearch:itemsPerPage>2</opensearch:itemsPerPage>
    </feed>