看知乎API
Via：http://www.kanzhihu.com/api-document
API文档
这里是很简陋的看知乎官方API文档0.1.5版。
当前版本不需要身份认证即可调用，但请大家注意节制，不要滥用。
本文档适合以下人群阅读：
对「看知乎」的网站感兴趣，准备开发APP或客户端的开发者；
对知乎用户数据和排行感兴趣的数据分析者；
不知道干什么就是想随便看看的闲人。
基本用法
API域名：http://api.kanzhihu.com
调用格式：目前只支持GET，URL格式为 http://api.kanzhihu.com/API名称，或者 http://api.kanzhihu.com/API名称/参数
返回数据：json
正确：{error : “”, data: … }
错误：{error : “…”}
服务器返回值之后首先检查error字段，如果不为空说明出错，为空再处理返回数据。
API列表
getposts
用途：获取「看知乎」首页文章列表，每次取10篇。
参数：时间戳（可选，留空时取最新10篇，有值时则取此时间戳之前的10篇）
返回值：
count(number)，本次获取文章数量（一般为10，也可能小于10）
posts(array)，文章信息列表，字段如下：
date(string)，发表日期（yyyy-mm-dd）
name(string)，文章名称（yesterday, recent, archive）
pic(string)，抬头图url
publishtime(number)，发表时间戳
count(number)，文章包含答案数量
excerpt(string)，摘要文字
如此时间戳之前无文章，则error==”no result”
描述：「看知乎」的答案推荐以文章为单位，每天在三个时段发布三篇，名字分别为昨日最新（yesterday）、近日热门（recent）和历史精华（archive），每篇推荐32~40个答案不等。本API就用于获取文章列表。如果要取更早的10篇（即向前翻页），则把当前最早一篇的时间戳作为参数即可。
示例：
http://api.kanzhihu.com/getposts
http://api.kanzhihu.com/getposts/1411261200
checknew
用途：检查「看知乎」首页在指定时间之后有没有更新
参数：时间戳（必选）
返回值：
result(bool)，是否有更新
描述：每次调用getposts获取最新文章之后，客户端应保存本次最新一篇发表的时间戳，之后通过调用此API查询是否已经发布了新文章，如果返回结果为true则再次调用getposts。
建议在每天稍晚于5:00、11:00、17:00的时间分别进行查询，或者为了考虑日后的兼容性，每小时查询一次。
示例：
http://api.kanzhihu.com/checknew/1444899600
getpostanswers
用途：获取单篇文章的答案列表
参数：日期（必选，8位数字，如20140925）、名称（必选：yesterday、recent、archive）
返回值：
count(number)，答案数量
answers(array)，答案列表，字段如下：
title(string)，文章id
time(datetime)，发表时间
summary(string)，答案摘要
questionid(string)，问题id，8位数字
answerid(string)，答案id，8~9位数字
authorname(string)，答主名称
authorhash(string)，答主hash
avatar(string)，答主头像url
vote(number)，赞同票数
如id不存在或没有答案，则error==”no result”
描述：通过文章列表获得某篇具体文章的日期及名称，然后通过本API获取文章中的答案列表。答案并未排序或者按照问题合并，开发者可以自行处理。
根据返回数据可以拼接以下url：
问题url：https://www.zhihu.com/question/questionid
答案url：https://www.zhihu.com/question/questionid/answer/answerid
用户主页url：https://www.zhihu.com/people/authorhash
示例：
http://api.kanzhihu.com/getpostanswers/20150925/archive
userdetail2
用途：获取用户详细页信息
参数：用户hash（必选）
返回值：
name(string)：用户名
avatar(string)：用户头像url
signature(string)：用户签名
description(string)：用户个人描述
detail(object)：用户详细数据
ask(number)：提问数
answer(number)：回答数
post(number)：专栏文章数
agree(number)：赞同数
agreei(number)：1日赞同数增加
agreeiratio(string)：1日赞同数增幅
agreeiw(number)：7日赞同数增加
agreeiratiow(string)：7日赞同数增幅
ratio(number)：平均赞同（总赞同数/(回答+专栏)）
followee(number)：关注数
follower(number)：被关注数（粉丝）
followeri(number)：1日被关注数增加
followiratio(string)：1日被关注数增幅
followeriw(number)：7日被关注数增加
followiratiow(string)：7日被关注数增幅
thanks(number)：感谢数
tratio(number)：感谢/赞同比
fav(number)：收藏数
fratio(number)：收藏/赞同比
logs(number)：公共编辑数
mostvote(number)：最高赞同
mostvotepercent(string)：最高赞同占比
mostvote5(number)：前5赞同
mostvote5percent(string)：前5赞同占比
mostvote10(number)：前10赞同
mostvote10percent(string)：前10赞同占比
count10000(number)：赞同≥10000答案数
count5000(number)：赞同≥5000答案数
count2000(number)：赞同≥2000答案数
count1000(number)：赞同≥1000答案数
count500(number)：赞同≥500答案数
count200(number)：赞同≥200答案数
count100(number)：赞同≥100答案数
star(object)：七星阵排名
answerrank：回答数+专栏文章数排名
agreerank：赞同数排名
ratiorank：平均赞同排名
followerrank：被关注数排名
favrank：收藏数排名
count1000rank：赞同超1000的回答数排名
count100rank：赞同超100的回答数排名
trend(array)，近日动态，字段如下：
date(string)，日期，格式为2014-09-25
answer(number)：回答数+专栏文章数
agree(number)：赞同数
follower(number)：被关注数
topanswers(array)，高票答案，字段如下：
title(string)，标题
link(string)：链接地址（不含域名）
agree(number)：赞同数
date(string)：日期，格式为2014-09-25
ispost(bool)：是否专栏文章，用于判断链接域名是zhihu.com还是zhuanlan.zhihu.com
如用户hash不存在，则error==”no result”
如用户存在，但当日没有他的数据（可能是数据抓取出错），则error==”no snapshot”
描述：通过答案列表或其他途径获得知乎用户hash，然后通过本API获取用户详细信息用于展示及分析。
其中detail包含了用户在最近一条快照中的各项数据；
star选择了detail中的七项代表性数据进行排名（由于看知乎的数据库并没有包含知乎全站，所以排名越靠后越不准确），之所以叫七星阵，是因为在最初版本的设计中这七项以雷达图形式显示，外观很像星星；
trend显示了用户最多最近30天内的动态，可以看出回答、赞同、粉丝的增长情况；
topanswers是最高票的10个答案（或专栏文章）。
示例：
http://api.kanzhihu.com/userdetail2/1f644a1b7da169d2b56e1a4c6da61fea
topuser
用途：获取某项指标排名前列的用户列表（分页）
参数：指标类型、页数（可选，最小为1）、每页条数（可选，最小为1，最大为50）
返回值：
count(number)，用户数量
topuser(array)，用户列表，字段如下：
id(string)：用户ID
name(string)：用户名称
hash(string)：用户hash
avatar(string)：用户头像url
signature(string)：用户签名
value(number)：某项指标的值，注意，这里的字段名不是“value”，而是调用API时传递的参数“指标类型”；
如传递agree，则这里的字段名就是agree。
如页数为空，则默认取第一页；
如每页条数为空，则默认每页30条；
如所选范围超出了前500名，则出错并返回空值；
如所选范围刚好落在500名前后，可能返回数量会小于每页条数；
所有指标类型列表与userdetail2的返回值里detail属性内容一致。
描述：本API实际是对用户分析所做的按列筛选和分页处理，适用于移动客户端。如果为了完整分析数据，仍然推荐直接使用用户分析或通过其中的json数据文件进行。
示例：
取赞同排名前30的用户http://api.kanzhihu.com/topuser/agree/1
取关注排名161~200的用户http://api.kanzhihu.com/topuser/follower/5/40
searchuser
用途：搜索用户
参数：搜索关键字
返回值：
count(number)，用户数量
users(array)，用户列表，字段如下：
id(string)：用户ID
name(string)：用户名称
hash(string)：用户hash
avatar(string)：用户头像url
signature(string)：用户签名
answer(number)：回答+专栏数量
agree(number)：赞同数量
follower(number)：被关注数量
如搜索不到结果，则error=”no user”
搜索结果按如下顺序排列：
首先是用户ID等于关键字的；
然后是用户名等于关键字的，按被关注数排序；
再后面是用户名包含关键字的，按被关注数排序。
示例：
http://api.kanzhihu.com/searchuser/aton
http://api.kanzhihu.com/searchuser/苏莉安
http://api.kanzhihu.com/searchuser/苏
