豆瓣 API 参考手册

用户

获取用户信息

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

返回值说明

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

例如

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

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

<?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/">
        <db:location id="beijing">北京</db:location>
        <db:uid>ahbei</db:uid>
        <title>阿北</title>
        <content>
            豆瓣的临时总管。现在多数时间在忙忙碌碌地为豆瓣添砖加瓦。坐在马桶上看书,算是一天中最放松的时间。
    
    
            我不但喜欢读书、旅行和音乐电影,还曾经是一个乐此不疲的实践者,有一墙碟、两墙书、三大洲的车船票为记。现在自己游荡差不多够了,开始懂得分享和回馈。豆瓣是一个开始,希望它对你同样有用。
        </content>
        <link rel="self" href="http://api.douban.com/people/ahbei" />
        <link rel="alternate" href="http://www.douban.com/people/ahbei/" />
        <link rel="icon" href="http://www.douban.com/icon/u1000001.jpg" />
    
        <link rel="homepage" href="http://ahbei.com/" />
        <id>http://api.douban.com/people/ahbei</id>
    </entry>

获取当前授权用户信息

必须先进行API认证授权,返回当前授权用户的信息。关于API认证授权的信息请参阅API 授权说明

GET http://api.douban.com/people/@me

例如

GET http://api.douban.com/people/@me

返回结果为一个Entry,包含当前授权用户的各种信息

<?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/">
        <db:location id="beijing">北京</db:location>
        <db:uid>ahbei</db:uid>
        <title>阿北</title>
        <content>
            豆瓣的临时总管。现在多数时间在忙忙碌碌地为豆瓣添砖加瓦。坐在马桶上看书,算是一天中最放松的时间。
    
    
            我不但喜欢读书、旅行和音乐电影,还曾经是一个乐此不疲的实践者,有一墙碟、两墙书、三大洲的车船票为记。现在自己游荡差不多够了,开始懂得分享和回馈。豆瓣是一个开始,希望它对你同样有用。
        </content>
        <link rel="self" href="http://api.douban.com/people/ahbei" />
        <link rel="alternate" href="http://www.douban.com/people/ahbei/" />
        <link rel="icon" href="http://www.douban.com/icon/u1000001.jpg" />
    
        <link rel="homepage" href="http://ahbei.com/" />
        <id>http://api.douban.com/people/ahbei</id>
    </entry>

搜索用户

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

请求参数

参数 意义 备注
q 全文检索的关键词
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/people?q=douban&start-index=10&max-results=5
            

返回结果为一个Feed,包含用户的列表

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
	<title>搜索 douban 的结果</title>
	<opensearch:startIndex>10</opensearch:startIndex>
	<opensearch:itemsPerPage>2</opensearch:itemsPerPage>
	<opensearch:totalResults>158</opensearch:totalResults>
	<entry>
		<id>http://api.douban.com/people/1000000</id>
		<title>六零</title>
		<link href="http://api.douban.com/people/1000000" rel="self"/>
		<link href="http://www.douban.com/people/douban/" rel="alternate"/>
		<content></content>
		<db:uid>douban</db:uid>
	</entry>
	<entry>
		<id>http://api.douban.com/people/1428797</id>
		<title>yangjiani</title>
		<link href="http://api.douban.com/people/1428797" rel="self"/>
		<link href="http://www.douban.com/people/www.douban.amy./" rel="alternate"/>
		<link href="http://t.douban.com/icon/u1428797-1.jpg" rel="icon"/>
		<link href="http://http://blog.sina.com.cn/yangjianiamy" rel="homepage"/>
		<content>日子过充实是真的很好
让你可以忘掉一切
一切的一切
再也没有了孤独~
也许他们这是偶尔躲我一下
但还是不错的样子

生活少了些暧昧
多了些真实
越来越不认识
~~~自己</content>
		<db:uid>www.douban.amy.</db:uid>
	</entry>
	<entry>
		<id>http://api.douban.com/people/1405403</id>
		<title>douban</title>
		<link href="http://api.douban.com/people/1405403" rel="self"/>
		<link href="http://www.douban.com/people/perfectlie/" rel="alternate"/>
		<link href="http://t.douban.com/icon/u1405403-1.jpg" rel="icon"/>
		<content></content>
		<db:uid>perfectlie</db:uid>
	</entry>
</feed>

获取用户朋友

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

获取用户关注的人

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

请求参数

参数 意义 备注
start-index 起始元素
max-results 返回结果的数量

例如

GET http://api.douban.com/people/ahbei/friends?start-index=1&max-results=2
            

返回结果为一个Feed,包含用户的列表

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:db="http://www.douban.com/xmlns/" xmlns:gd="http://schemas.google.com/g/2005" xmlns:opensearch="http://a9.com/-/spec/opensearchrss/1.0/">
	<title>阿北 的朋友</title>
	<author>
		<link href="http://api.douban.com/people/ahbei" rel="self"/>
		<link href="http://www.douban.com/people/ahbei/" rel="alternate"/>
		<link href="http://t.douban.com/icon/u1000001-14.jpg" rel="icon"/>
		<name>阿北</name>
		<uri>http://api.douban.com/people/1000001</uri>
	</author>
	<opensearch:startIndex>1</opensearch:startIndex>
	<opensearch:itemsPerPage>2</opensearch:itemsPerPage>
	<opensearch:totalResults>114</opensearch:totalResults>
	<entry>
		<id>http://api.douban.com/people/1010394</id>
		<title>Engo@寻各种达人</title>
		<link href="http://api.douban.com/people/1010394" rel="self"/>
		<link href="http://www.douban.com/people/akin/" rel="alternate"/>
		<link href="http://t.douban.com/icon/u1010394-10.jpg" rel="icon"/>
		<link href="http://www.halfull.cn" rel="homepage"/>
		<content>但行好事,莫问前程。

http://www.douban.com/group/topic/3750385/ 寻各种达人

我的"朋友"
那会是已经认识很久或将要认识并能持续很久的人,谢谢。</content>

		<db:location id="beijing">北京</db:location>
		<db:uid>akin</db:uid>
	</entry>
	<entry>
		<id>http://api.douban.com/people/1276180</id>
		<title>蒜王子(((♪)))</title>
		<link href="http://api.douban.com/people/1276180" rel="self"/>
		<link href="http://www.douban.com/people/movie007wn/" rel="alternate"/>
		<link href="http://t.douban.com/icon/u1276180-40.jpg" rel="icon"/>
		<content>♂┣▇▇▇═—。
ருவசிர்ம்ர்ளேசி</content>
		<db:location id="beijing">北京</db:location>
		<db:uid>movie007wn</db:uid>
	</entry>
</feed>