开局就是瑟图一份（pixiv id: 71123098

前言

本次上线的API为基于pixivpy实现的Pixiv HTTP API。本来是打算重构随机图片API的，然后又需要采集图片的信息（敏感度什么的），最后决定自己搞一个HTTP的API方便调用。

名词解释

illust：指在pixiv图站的作品（包括但不限于单张图片、多张图片集（又称漫画）、连载图片）

user：指在pixiv图站中的注册用户

功能简介

• 获取illust的信息
• 获取illust的类似（相关）illust
• 获取user的公开信息
• 获取user的公开作品
• 获取pixiv排行（日、周、月）（待实现）（不存在的，太懒了）（逃

简易文档（凑合着看吧）

API版本：1.0

API服务地址：https://api.few.gs/pixiv/

支持的请求方式：GET

鉴权（认证）方式：暂无

频率限制：每分钟30次（大概是所有功能共用的）（我也不太清楚）（反正是设了）（

接口列表

获取illust信息

功能接口：illust/info/{illust_id}

其中，{illust_id}请替换为实际请求的illust的id

---

获取illust的相关illust

功能接口：illust/relation/{illust_id}

---

获取user的公开信息

功能接口：user/info/{user_id}

其中，{user_id}请替换为实际请求的user的id

---

获取user的作品列表

功能接口：user/illust/{user_id}/{offset}

由于API接口自身的限制，每次只能获取同一个作者30张作品（从最新的那张开始获取）。因此，如果作者作品数量多于30张的话，需要添加offset参数来分批获取。

其中offset参数为可选参数，默认为0，即从编号0开始获取，到编号29（顺序编号），共30张作品。当作品数量大于30张的时候，第一次请求请将offset留空，第二次请求offset为30，第三次offset为60……第n次的offset为(n-1)*30，直到data里面的illusts为空为止。

---

获取pixiv排行

（待实现）

返回数据结构

格式：JSON

必含字段：error

当error为0时，数据位于data字段中（具体数据结构请参考具体返回值）

当error不为0时，错误信息位于msg字段中

测试例子

想要获取illust id为5171516的作品的信息，则实际请求URL应为：

https://api.few.gs/pixiv/illust/info/5171516

在linux下调试：

curl https://api.few.gs/pixiv/illust/info/5171516

隐私声明

岁月小筑（以下简称本站）可能会记录请求参数、请求发起IP、调用次数、调用时间等数据，使用本API即视为了解并接受此协议。

本站拥有对岁月小筑Pixiv HTTP API的最终解释权。