Pixiv Web Api

🅿️ 開源閱讀 Pixiv 書源

✈️ 頻道 @PixivSource

WARNING

⚠️ 你正在 GitHub 上瀏覽此文件， Github 文件可能不完整網頁版內容更全面，排版更精美

CAUTION

免責宣告

本文件記錄的是 Pixiv 官方網站使用的 Web API，並非官方公開文件。
本文件不保證任何介面的準確性、完整性、時效性、可用性、穩定性，Pixiv 可隨時變更或關閉。
本文件僅供學習與研究使用。本文件作者與維護者不對因使用本文件提及的介面導致的任何直接或間接損失承擔責任。
本文件與 Pixiv Inc. 無任何關聯。

使用本文件即表示：您已閱讀並同意以上全部內容。

快速跳轉

NOTE

🔎 搜尋作品； 🏡 首頁推薦； 📖 小說首頁； 💈 側邊欄； 📄 小說資訊； ▶️ 小說互動； 💬 小說評論； 👤 使用者互動； 🖼 插畫

搜尋

NOTE

搜尋： 🔎 搜尋作品； 📖 搜尋小說； 👤 搜尋作者

🔎 搜尋作品

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、`1`AI
`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`
`p`	Query	Integer	頁碼
`s_mode`	Query	String	檢索範圍：`s_tag` 標籤部分一致、`s_tag_full` 標籤完全一致、`tag_tc` 標籤標題說明文字、`tc` 標籤說明文字
`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=s_tag&lang=zh

對應網頁

https://www.pixiv.net/search?q=中文&s_mode=s_tag&type=novel&work_lang=zh-cn

📖 搜尋小說(全)

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=s_tag&lang=zh

對應網頁

https://www.pixiv.net/search?q=中文&s_mode=s_tag&type=novel&work_lang=zh-cn

👤 搜尋作者

TIP

搜尋使用者

URL：https://www.pixiv.net/ajax/search/users
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`nick`	Query	String	暱稱
`s_mode`	Query	String	模式：`s_usr` 部分一致、`s_usr_full` 完全一致
`i`	Query	Integer	[可選]有無投稿：`1` 是（預設）、`0` 否
`comment`	Query	Integer	不明：空或數字：`comment=`、`comment=1`
`p`	Query	Integer	頁碼
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/search/users?nick=null&s_mode=s_usr&i=1&p=1&lang=zh

對應網頁

https://www.pixiv.net/search/users?nick=null&s_mode=s_usr&i=1&p=1

首頁推薦

NOTE

首頁推薦： #️⃣ 推薦標籤； 🆕 精選新作； 👤 推薦使用者； 👍 推薦作品

#️⃣ 推薦標籤

TIP

首頁推薦標籤

URL：https://www.pixiv.net/ajax/street/recommend_tags
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/street/recommend_tags

對應網頁

https://www.pixiv.net

🆕 精選新作

TIP

首頁精選新作（插畫）

URL：https://www.pixiv.net/ajax/street/latest
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/street/latest?lang=zh

對應網頁

https://www.pixiv.net

👤 推薦使用者

TIP

首頁推薦使用者、正在舉辦的比賽

URL：https://www.pixiv.net/ajax/street/sub
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/street/sub?lang=zh

對應網頁

https://www.pixiv.net

👍 推薦作品

TIP

推薦作品

URL：https://www.pixiv.net/ajax/street/for_you
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/street/for_you?lang=zh

對應網頁

https://www.pixiv.net

小說首頁

NOTE

按照 Pixiv 小說首頁順序排序排序：

⭐️ 已關注使用者的作品； 📃 追更列表中的作品； 👍 編輯部的推薦作品； 🔥 原創熱門作品； 💯 推薦作品； 👑 每日排行榜； 📑 矚目的企劃目錄； 💰 小說約稿作品

⭐️ 關注使用者

TIP

已關注使用者的（最新）作品 / 關注使用者，最新小說

URL：https://www.pixiv.net/ajax/follow_latest/novel
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`p`	Query	Integer	頁碼
`mode`	Query	String	年齡限制：`all`、`safe`、`r18`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/follow_latest/novel?p=1&mode=r18&lang=zh

對應網頁

https://www.pixiv.net/novel/bookmark_new_r18.php

📃 追更列表

TIP

追更列表中的作品

URL：https://www.pixiv.net/ajax/watch_list/novel
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`page`	Query	Integer	頁碼
`new`	Query	Integer	`1`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/watch_list/novel?p=1&new=1&lang=zh

對應網頁

https://www.pixiv.net/following/watchlist/novels

👍 編輯部推薦

TIP

編輯部的推薦作品 （僅日語）

URL：https://www.pixiv.net/ajax/novel/editors_picks
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`limit`	Query	Integer	`30`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/novel/editors_picks?limit=30&lang=zh

對應網頁

https://www.pixiv.net/novel/editors_picks

🔥 原創熱門

TIP

原創熱門作品 (分類)

URL：https://www.pixiv.net/ajax/genre/novel/{genre}
請求方法: GET
傳參方式: PATH & QUERY

引數說明

引數	位置	型別	說明
`genre`	Path	String	僅 `safe`：`all` 綜合僅 `r18`：`male` 男性、`female` 女性全部：`romance` 戀愛、`isekai_fantasy` 異世界奇幻、`contemporary_fantasy` 現代奇幻、`mystery` 懸疑、`horror` 恐怖、`sci-fi` 科幻、`literature` 文學、`drama` 情感、`historical_pieces` 歷史、`bl` 耽美、`yuri` 百合、`poetry` 散文·詩歌、`non-fiction` 隨筆·紀實、`screenplays` 劇本、`reviews` 評論、`other` 其他
`mode`	Query	String	年齡限制：`safe`、`r18`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/genre/novel/male?mode=r18&lang=zh

對應網頁

https://www.pixiv.net/genre/novel/male?mode=r18

💯 推薦作品

URL: https://www.pixiv.net/ajax/top/novel
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`mode`	Query	String	年齡限制：`all`、`r18`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/top/novel?mode=all&lang=zh

對應網頁

https://www.pixiv.net/novel

👑 小說排行榜

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

📑 小說企劃

TIP

使用者企劃 - 小說

URL: https://www.pixiv.net/ajax/user_event/portal/novels
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`mode`	Query	String	年齡限制：`all`、`r18`
`p`	Query	Integer	頁碼
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/user_event/portal/novels?mode=r18&p=1&lang=zh

對應網頁

https://www.pixiv.net/user_event.php?type=novels&mode=r18

💰 小說約稿

TIP

已完成的約稿 - 小說

URL: https://www.pixiv.net/ajax/commission/page/request/complete/novels
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`mode`	Query	String	年齡限制：`all`、`safe`、`r18`
`p`	Query	Integer	頁碼
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/commission/page/request/complete/novels?mode=r18&p=1&lang=zh

對應網頁

https://www.pixiv.net/request/complete/novels?mode=r18

NOTE

按照 Pixiv 小說首頁側邊欄順序排序：

⭐️ 已關注使用者的最新作品； 🔍 發現； 👑 排行榜； 🆕 本站的最新作品； 💰 約稿； 📑 使用者企劃

🔍 發現小說

TIP

發現 - 推薦作品 - 小說

URL: https://www.pixiv.net/ajax/novel/discovery
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`mode`	Query	String	年齡限制：`all`、`safe`、`r18`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/novel/discovery?mode=r18&lang=zh

對應網頁

https://www.pixiv.net/novel/discovery?mode=r18

🆕 最新作品

TIP

本站的最新作品 / 大家的新作

URL: https://www.pixiv.net/ajax/novel/new
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`lastId`	Query	Integer	`0`
`limit`	Query	Integer	`20`
`r18`	Query	Boolean	`true`、`false`
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/novel/new?lastId=0&limit=20&r18=true&lang=zh

對應網頁

https://www.pixiv.net/novel/new_r18.php

小說資訊

NOTE

小說資訊： 📄 小說詳情

📄 小說詳情

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

請求方法：GET
傳參方式：PATH

引數說明

引數	位置	型別	說明
novelId	PATH	Integer	小說 ID

呼叫示例

https://www.pixiv.net/ajax/novel/123455

對應網頁

https://www.pixiv.net/novel/show.php?id=123455

小說互動

NOTE

小說互動： ❤️ 收藏單篇小說； 📖 小說收藏資料； 🖤 取消收藏小說； 📃 追更系列小說； 📃 取消追更系列🏷️ 新增刪除書籤； ✅ 提交小說投票

❤️ 收藏單篇小說

URL：https://www.pixiv.net/ajax/novels/bookmarks/add
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	必填	說明
`novel_id`	Body	String	是	目標小說 ID
`restrict`	Body	Integer	是	收藏許可權：`0` 公開收藏、`1` 私密收藏(僅自己可見)
`comment`	Body	String	否	收藏備註，預設為空字串
`tags`	Body	Array	否	收藏標籤，預設為空陣列

請求體示例

json

{
  "novel_id": "12345678",
  "restrict": 0,
  "comment": "",
  "tags": []
}

📖 小說收藏資料

URL：https://www.pixiv.net/ajax/novel/{novelId}/bookmarkData
請求方法: GET
傳參方式: PATH

引數說明

引數	位置	型別	說明
`novelId`	Path	Integer	目標小說 ID

呼叫示例

https://www.pixiv.net/ajax/novel/12345678/bookmarkData

響應示例

json

{
	"error": false,
	"message": "",
	"body": {
		"id": 12345678,
		"isBookmarkable": true,
		"bookmarkData": {
			"id": "912321341",
			"private": false
		}
	}
}

🖤 取消收藏小說

URL：https://www.pixiv.net/ajax/novels/bookmarks/delete
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`del`	Body	Integer	操作標識，固定 `1`
`book_id`	Body	Integer	收藏夾記錄 ID

請求體示例

del=1&book_id=987654321

🖤 取消收藏小說批次

URL：https://www.pixiv.net/ajax/novels/bookmarks/remove
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	說明
bookmarkIds	Body	Array	收藏夾記錄 ID 列表

請求體示例

json

{
  "bookmarkIds": [
    "987654321",
    "987654322"
  ]
}

📃 追更系列小說

TIP

僅限系列小說

URL：https://www.pixiv.net/ajax/novel/series/{seriesId}/watch
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	說明
`seriesId`	Path	Integer	系列小說 ID

請求體示例

json

{}

📃 取消追更系列小說

TIP

僅限系列小說

URL：https://www.pixiv.net/ajax/novel/series/{seriesId}/unwatch
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	說明
`seriesId`	Path	Integer	系列小說 ID

請求體示例

json

{}

🏷️ 新增刪除書籤

URL：https://www.pixiv.net/novel/rpc_marker.php
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`mode`	Body	String	操作模式，固定傳 `save`
`i_id`	Body	Integer	小說 ID
`u_id`	Body	Integer	使用者 ID
`page`	Body	Integer	小說頁碼：`0` 刪除書籤，其他新增書籤

請求體示例

mode=save&i_id=12345678&u_id=87654321&page=1

✅ 提交小說投票

URL：https://www.pixiv.net/ajax/novel/{novelId}/poll/answer
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	說明
`novelId`	Path	Integer	小說 ID
`choice_id`	Body	Integer	投票選項，數字1-5

請求體示例

json

{
  "choice_id": 1
}

小說評論

NOTE

💬 傳送小說評論； 📖 獲取評論資料； 📖 獲取評論回覆； 🗑 刪除小說評論

💬 傳送小說評論

TIP

傳送小說評論、回覆小說評論

URL：https://www.pixiv.net/novel/rpc/post_comment.php
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`type`	Body	String	評論型別，固定傳 `comment`
`novel_id`	Body	Integer	小說 ID
`author_user_id`	Body	Integer	當前使用者 ID
`comment`	Body	String	評論的具體內容（需經過 URL 編碼）
`parent_id`	Body	Integer	[可選] 回覆的目標評論 ID（若為根評論則不傳）

請求體示例

type=comment&novel_id=12345678&author_user_id=87654321&comment=testComment

📖 獲取評論資料

URL：https://www.pixiv.net/ajax/novels/comments/roots
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`novel_id`	Query	Integer	小說 ID
`offset`	Query	Integer	偏移量（分頁起始位置，如 `0`）
`limit`	Query	Integer	每頁返回數量限制（如 `50`）
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/novels/comments/roots?novel_id=12345678&offset=0&limit=50&lang=zh

📖 獲取評論回覆

URL：https://www.pixiv.net/ajax/novels/comments/replies
請求方法: GET
傳參方式: QUERY

引數說明

引數	位置	型別	說明
`comment_id`	Query	String / Integer	父評論 ID
`page`	Query	Integer	頁碼
`lang`	Query	String	語言：`zh` 中文

呼叫示例

https://www.pixiv.net/ajax/novels/comments/replies?comment_id=987654321&page=1&lang=zh

🗑 刪除小說評論

URL：https://www.pixiv.net/novel/rpc_delete_comment.php
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`i_id`	Body	Integer	小說 ID
`del_id`	Body	Integer	刪除評論 ID

請求體示例

i_id=12345678&del_id=987654321

使用者互動

NOTE

⭐️ 關注使用者； ⭐️ 取消關注使用者； 🚫 拉黑使用者

⭐️ 關注使用者

URL：https://www.pixiv.net/bookmark_add.php
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`mode`	Body	String	操作模式，固定傳 `add`
`type`	Body	String	關注型別，固定傳 `user`
`user_id`	Body	Integer	目標作者的使用者 ID
`tag`	Body	String	關注標籤，預設為空 `""`
`restrict`	Body	Integer	關注許可權：`0` 公開關注、`1` 私密關注
`format`	Body	String	響應資料格式，固定傳 `json`

請求體示例

mode=add&type=user&user_id=12345678&tag=""&restrict=0&format=json

⭐️ 取消關注使用者

URL：https://www.pixiv.net/rpc_group_setting.php
請求方法: POST
Content-Type: application/x-www-form-urlencoded

引數說明

引數	位置	型別	說明
`mode`	Body	String	操作模式，固定傳 `del`
`type`	Body	String	取消關注的型別，固定傳 `bookuser`
`id`	Body	Integer	目標作者的使用者 ID

請求體示例

mode=del&type=bookuser&id=12345678

🚫 拉黑使用者

TIP

拉黑使用者，禁止其點贊、評論、收藏、關注、私信等

URL：https://www.pixiv.net/ajax/block/save
請求方法: POST
Content-Type: application/json

引數說明

引數	位置	型別	說明
`user_id`	Body	Integer	使用者 UID
`action`	Body	String	操作行為：`block` 拉黑、`unblock` 取消拉黑

請求體示例 (JSON)

json

{
  "user_id": "12345678",
  "action": "block"
}

插畫

👑 插畫排行榜

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