Pixiv Web Api

🅿️ 开源阅读 Pixiv 书源

✈️ 频道 @PixivSource

WARNING

⚠️ 你正在 GitHub 上浏览此文档， Github 文档可能不完整 网页版 内容更全面，排版更精美

搜索

🔎 搜索

• URL：https://www.pixiv.net/ajax/search/{type}/{name}
• 请求方法: GET
• 传参方式: PATH & QUERY

参数说明

参数名	位置	类型	说明
type	Path	String	作品类型：artwork 插画漫画动图、illust_ugoira 插画动图、illust 插画、ugoira 动图、manga 漫画、novel 小说
name	Path	String	关键词
word	Query	String	关键词 (同 name)
order	Query	String	排序方式：date_d 最新、date 最旧
mode	Query	String	年龄限制：all、safe、 r18
p	Query	Integer	页码
ai_type	Query	Integer	[可选]AI作品：0非AI、1AI
s_mode	Query	String	检索范围：s_tag 标签部分一致、s_tag_full 标签完全一致、tag_tc 标签标题说明文字、tc 标签说明文字

🔎 搜索小说

• URL：https://www.pixiv.net/ajax/search/{type}/{name}
• 请求方法: GET
• 传参方式: PATH & QUERY

参数说明

参数名	位置	类型	说明
type	Path	String	作品类型：novel 小说
name	Path	String	关键词
word	Query	String	关键词 (同 name)
order	Query	String	排序方式：date_d 最新、date 最旧
mode	Query	String	年龄限制：all、safe、 r18
scd	Query	String	[可选]开始时间：0 否、2026-01-01
ecd	Query	String	[可选]结束时间：0 否、2026-07-01
p	Query	Integer	页码
ai_type	Query	Integer	[可选]AI作品：0 否、1 是
csw	Query	Integer	[可选]整合作者：0 否、1 是
s_mode	Query	String	检索范围：s_tag 标签部分一致、s_tag_full 标签完全一致、tag_tc 标签标题说明文字、tc 标签说明文字
tlt	Query	Integer	[可选]正文字数下限：0 否、5000
tgt	Query	Integer	[可选]正文字数上限：0 否、5000
wlt	Query	Integer	[可选]正文单词下限：0 否、5000
wgt	Query	Integer	[可选]正文单词上限：0 否、5000
original_only	Query	Integer	[可选]仅限原创：0 否、1 是
genre	Query	Integer	[可选]分类：详见 https://www.pixiv.net/genre/novel
gs	Query	Integer	[可选]整合系列：0 否、1 是
lang	Query	String	语言：zh 中文

调用示例

https://www.pixiv.net/ajax/search/novels/中文?word=中文&order=date_d&mode=all&p=1&s_mode=tag_tc&lang=zh

对应网页

https://www.pixiv.net/search?q=%E4%B8%AD%E6%96%87&s_mode=tag_tc&type=novel&work_lang=zh-cn

推荐

⭐️ 推荐

👑 插画排行榜

• URL: https://www.pixiv.net/ranking.php
• 请求方法: GET
• 传参方式: QUERY

参数说明

参数名	位置	类型	说明
mode	Query	String	模式： daily 今日、weekly 本周、monthly 本月、rookie 新人 、original 原创、daily_ai AI生成、male 受男性欢迎、female 受女性欢迎 daily_r18 今日、weekly_r18 本周、daily_r18_ai AI生成、 male_r18 受男性欢迎、female_r18 受女性欢迎、r18g R18G
content	Query	String	内容：all 综合、illust 插画、manga 漫画、ugoira 动图
format	Query	String	数据格式：固定为 json
p	Query	Integer	页码

调用示例

https://www.pixiv.net/ranking.php?mode=daily&content=all

对应网页

https://www.pixiv.net/ranking.php?mode=daily&content=all&format=json&p=1

👑 小说排行榜

• URL: https://www.pixiv.net/ajax/ranking/novel
• 请求方法: GET
• 传参方式: QUERY
• 推出时间：2026-07

参数说明

参数名	位置	类型	说明
mode	Query	String	模式： daily 今日、weekly 本周、monthly 本月、rookie 新人 、weekly_original 原创、weekly_ai AI生成、male 受男性欢迎、female 受女性欢迎 daily_r18 今日、weekly_r18 本周、weekly_r18_ai AI生成、 male_r18 受男性欢迎、female_r18 受女性欢迎、r18g R18G
content	Query	String	内容：novel 小说
p	Query	Integer	页码：1 或 2
lang	Query	String	语言：zh 中文、ja 日语

调用示例

https://www.pixiv.net/ajax/ranking/novel?mode=daily_r18&content=novel&p=1

对应网页

https://www.pixiv.net/novel/ranking.php?mode=daily_r18

小说信息

小说详情

https://www.pixiv.net/ajax/novel/${novelId}

• 请求方法：GET
• 传参方式：PATH
• 参数：
  • novelId：小说作品 ID
• 示例：https://www.pixiv.net/ajax/novel/123455
• 网页：https://www.pixiv.net/novel/show.php?id=123455

小说互动

▶️ 互动