mirror of
https://github.com/LamGC/ContentGrabbingJi.git
synced 2025-04-30 14:47:33 +00:00
LamGC
6b47e19569
[Change] Pixiv排行榜接口.md 整理文档格式; [Add] Pixiv搜索接口.md 添加Url参数"Type"与返回数据中类型存在与否的关系表; [Add] Pixiv搜索接口.md 补充了其他属性的信息;
398 lines
15 KiB
Markdown
398 lines
15 KiB
Markdown
## Pixiv内容搜索接口 ##
|
||
### 说明 ###
|
||
> 注意: 本接口可能会影响Pixiv对账号的行为判断（猜测，不一定会）
|
||
|
||
该接口用于在Pixiv搜索内容。
|
||
|
||
### 接口地址 ###
|
||
```
|
||
GET https://www.pixiv.net/ajax/search/{Type}/{Content}?{Param...}
|
||
```
|
||
|
||
- 是否需要登录: `是/否`
|
||
- 是否为Pixiv标准接口返回格式: `是/否`
|
||
- 是否需要Referer请求头: `否`
|
||
|
||
### 参数 ###
|
||
#### Url参数 ####
|
||
- `Type`: 内容类型
|
||
- `artworks` - 所有类型
|
||
- `top` - 推荐
|
||
- `illustrations` - 插画
|
||
- `manga` - 漫画
|
||
- `novels` - 小说
|
||
- `tags` - 查询标签信息
|
||
- `Content`: 搜索内容
|
||
|
||
#### GET参数 ####
|
||
##### 必填 #####
|
||
> 注意：除 `tags` 类型外，其他内容类型都需要以下参数。
|
||
- `word`: 与搜索内容一致 (经测试似乎可以省略)
|
||
- `s_mode`: 匹配模式
|
||
- `s_tag`: 标签，部分一致
|
||
- `s_tag_full`: 标签，完全一致
|
||
- `s_tc`: 标签和说明文字
|
||
- `type`: 作品类型
|
||
- `all`: 插画、漫画和动图
|
||
- `illust_and_ugoira`: 插画和动图
|
||
- `illust`: 仅插画
|
||
- `manga`: 仅漫画
|
||
- `ugoira`: 仅动图
|
||
- `p`: 指定页数 (当指定页数超出范围后，`body.illust.data`为空数组)
|
||
- `order`: 排序设置
|
||
- `date`: 按时间从旧到新
|
||
- `date_d`: 按时间从新到旧
|
||
- `(Unknown)`: 未知, 猜测是会员功能的热门搜索
|
||
- `mode`: 内容分级设置
|
||
- `all`: 全部内容
|
||
- `safe`: 排除成人内容
|
||
- `r18`: 仅成人内容
|
||
|
||
##### 选填 #####
|
||
- `wlt`: 作品最低宽度(px)
|
||
- `wgt`: 作品最高宽度(px)
|
||
- `hlt`: 作品最低高度(px)
|
||
- `hgt`: 作品最高高度(px)
|
||
- `ratio`: 作品横宽比过滤 (初步测试表明，该参数无法指定横宽比，可能暂不支持该功能)
|
||
- `0.5`: 仅横图
|
||
- `-0.5`: 仅纵图
|
||
- `0`: 仅正方形图
|
||
- `tool`: 限定作品绘制工具
|
||
- `scd`: 过滤作品发布时间 - 开始时间(yyyy-MM-dd)
|
||
- `scd`: 过滤作品发布时间 - 结束时间(yyyy-MM-dd)
|
||
- `(Unknown)`: 最小收藏数 (该参数为会员限定功能，后续补充)
|
||
|
||
### 返回数据 ###
|
||
#### 数据示例 ####
|
||
```json
|
||
{
|
||
"error":false,
|
||
"body":{
|
||
"illustManga":{
|
||
"data":[
|
||
{
|
||
"illustId":"82130571",
|
||
"illustTitle":"空の絵",
|
||
"id":"82130571",
|
||
"title":"空の絵",
|
||
"illustType":0,
|
||
"xRestrict":0,
|
||
"restrict":0,
|
||
"sl":2,
|
||
"url":"https:\/\/i.pximg.net\/c\/250x250_80_a2\/img-master\/img\/2020\/06\/06\/17\/51\/14\/82130571_p0_square1200.jpg",
|
||
"description":"",
|
||
"tags":[
|
||
"風景",
|
||
"空",
|
||
"草",
|
||
"雲"
|
||
],
|
||
"userId":"31507675",
|
||
"userName":"昏omeme",
|
||
"width":1600,
|
||
"height":1600,
|
||
"pageCount":2,
|
||
"isBookmarkable":true,
|
||
"bookmarkData":null,
|
||
"alt":"#風景 空の絵 - 昏omeme的插画",
|
||
"isAdContainer":false,
|
||
"titleCaptionTranslation":{
|
||
"workTitle":null,
|
||
"workCaption":null
|
||
},
|
||
"createDate":"2020-06-06T17:51:14+09:00",
|
||
"updateDate":"2020-06-06T17:51:14+09:00",
|
||
"profileImageUrl":"https:\/\/i.pximg.net\/user-profile\/img\/2020\/05\/06\/19\/21\/04\/18509741_e3166e69809c44d6926454ecaac89590_50.png"
|
||
}, // ...
|
||
],
|
||
"total":165875,
|
||
"bookmarkRanges":[
|
||
{
|
||
"min":null,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":10000,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":5000,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":1000,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":500,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":300,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":100,
|
||
"max":null
|
||
},
|
||
{
|
||
"min":50,
|
||
"max":null
|
||
}
|
||
]
|
||
},
|
||
"popular":{
|
||
"recent":[
|
||
{
|
||
"illustId":"82062770",
|
||
"illustTitle":"Still you remember",
|
||
"id":"82062770",
|
||
"title":"Still you remember",
|
||
"illustType":0,
|
||
"xRestrict":0,
|
||
"restrict":0,
|
||
"sl":2,
|
||
"url":"https:\/\/i.pximg.net\/c\/250x250_80_a2\/img-master\/img\/2020\/06\/03\/18\/02\/15\/82062770_p0_square1200.jpg",
|
||
"description":"",
|
||
"tags":[
|
||
"オリジナル",
|
||
"女の子",
|
||
"カラス",
|
||
"风景",
|
||
"線路"
|
||
],
|
||
"userId":"1069005",
|
||
"userName":"へちま",
|
||
"width":2000,
|
||
"height":1415,
|
||
"pageCount":1,
|
||
"isBookmarkable":true,
|
||
"bookmarkData":null,
|
||
"alt":"#オリジナル Still you remember - へちま的插画",
|
||
"isAdContainer":false,
|
||
"titleCaptionTranslation":{
|
||
"workTitle":null,
|
||
"workCaption":null
|
||
},
|
||
"createDate":"2020-06-03T18:02:15+09:00",
|
||
"updateDate":"2020-06-03T18:02:15+09:00",
|
||
"profileImageUrl":"https:\/\/i.pximg.net\/user-profile\/img\/2013\/05\/10\/00\/38\/05\/6213543_c94edc0d13776214467bd0c47ee6491a_50.jpg"
|
||
}, // ...
|
||
],
|
||
"permanent":[
|
||
{
|
||
"illustId":"60993044",
|
||
"illustTitle":"無題",
|
||
"id":"60993044",
|
||
"title":"無題",
|
||
"illustType":0,
|
||
"xRestrict":0,
|
||
"restrict":0,
|
||
"sl":2,
|
||
"url":"https:\/\/i.pximg.net\/c\/250x250_80_a2\/img-master\/img\/2017\/01\/18\/13\/07\/46\/60993044_p0_square1200.jpg",
|
||
"description":"",
|
||
"tags":[
|
||
"少女",
|
||
"女の子",
|
||
"原创",
|
||
"オリジナル",
|
||
"场景",
|
||
"落書き",
|
||
"創作",
|
||
"背景",
|
||
"风景",
|
||
"オリジナル7500users入り"],
|
||
"userId":"18811972",
|
||
"userName":"淅洵",
|
||
"width":3507,
|
||
"height":2480,
|
||
"pageCount":1,
|
||
"isBookmarkable":true,
|
||
"bookmarkData":null,
|
||
"alt":"#少女 無題 - 淅洵的插画",
|
||
"isAdContainer":false,
|
||
"titleCaptionTranslation":{
|
||
"workTitle":null,
|
||
"workCaption":null
|
||
},
|
||
"createDate":"2017-01-18T13:07:46+09:00",
|
||
"updateDate":"2017-01-18T13:07:46+09:00",
|
||
"profileImageUrl":"https:\/\/i.pximg.net\/user-profile\/img\/2017\/05\/29\/17\/17\/49\/12623968_6cf3f1979e10643425972ae205a7920d_50.jpg"
|
||
}, // ...
|
||
]
|
||
},
|
||
"relatedTags":[
|
||
"風景",
|
||
"背景",
|
||
"風景画",
|
||
"空",
|
||
"雲",
|
||
"創作",
|
||
"ファンタジー",
|
||
"夏",
|
||
"青",
|
||
"建物",
|
||
"青空",
|
||
"少女",
|
||
"東京",
|
||
"抽象画",
|
||
"男の子",
|
||
"透明水彩"
|
||
],
|
||
"tagTranslation":{
|
||
"風景":{
|
||
"zh":"风景"
|
||
},
|
||
"背景":{
|
||
"zh":"background"
|
||
},
|
||
"風景画":{
|
||
"zh":"landscape painting"
|
||
},
|
||
"空":{
|
||
"zh":"sky"
|
||
},
|
||
"雲":{
|
||
"zh":"云"
|
||
},
|
||
"創作":{
|
||
"zh":"原创"
|
||
},
|
||
"ファンタジー":{
|
||
"zh":"奇幻"
|
||
},
|
||
"夏":{
|
||
"zh":"夏天"
|
||
},
|
||
"青":{
|
||
"zh":"蓝"
|
||
},
|
||
"建物":{
|
||
"zh":"building"
|
||
},
|
||
"青空":{
|
||
"zh":"蓝天"
|
||
},
|
||
"少女":{
|
||
"zh":"young girl"
|
||
},
|
||
"東京":{
|
||
"zh":"tokyo"
|
||
},
|
||
"抽象画":{
|
||
"zh":"abstract art"
|
||
},
|
||
"男の子":{
|
||
"zh":"男孩子"
|
||
},
|
||
"透明水彩":{
|
||
"zh":"transparent watercolor"
|
||
}
|
||
},
|
||
"zoneConfig":{
|
||
"header":{
|
||
"url":"https:\/\/pixon.ads-pixiv.net\/show?zone_id=header&format=js&s=1&up=0&a=22&ng=g&l=zh&uri=%2Fajax%2Fsearch%2Fartworks%2F_PARAM_&is_spa=1&K=59bba275c645c&ab_test_digits_first=20&yuid=FwdzEnA&suid=Pgfip96ymw5tvu9l9&num=5edb6277927"
|
||
},
|
||
"footer":{
|
||
"url":"https:\/\/pixon.ads-pixiv.net\/show?zone_id=footer&format=js&s=1&up=0&a=22&ng=g&l=zh&uri=%2Fajax%2Fsearch%2Fartworks%2F_PARAM_&is_spa=1&K=59bba275c645c&ab_test_digits_first=20&yuid=FwdzEnA&suid=Pgfip96yn1fgocj2&num=5edb6277775"
|
||
},
|
||
"infeed":{
|
||
"url":"https:\/\/pixon.ads-pixiv.net\/show?zone_id=illust_search_grid&format=js&s=1&up=0&a=22&ng=g&l=zh&uri=%2Fajax%2Fsearch%2Fartworks%2F_PARAM_&is_spa=1&K=59bba275c645c&ab_test_digits_first=20&yuid=FwdzEnA&suid=Pgfip96yn4t7cho88&num=5edb6277137"
|
||
}
|
||
},
|
||
"extraData":{
|
||
"meta":{
|
||
"title":"#风景のイラスト・マンガ作品(投稿超过10万件） - pixiv",
|
||
"description":"pixiv",
|
||
"canonical":"https:\/\/www.pixiv.net\/tags\/%E9%A3%8E%E6%99%AF",
|
||
"alternateLanguages":{
|
||
"ja":"https:\/\/www.pixiv.net\/tags\/%E9%A3%8E%E6%99%AF",
|
||
"en":"https:\/\/www.pixiv.net\/en\/tags\/%E9%A3%8E%E6%99%AF"
|
||
},
|
||
"descriptionHeader":"pixiv"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
> 注意：根据 Url 参数中 `Type` 的不同，返回数据的属性也会出现差异，
|
||
详见字段说明下的【请求 Url 中的 Type 与返回数据中属性的关系】表格
|
||
|
||
#### 字段说明 ####
|
||
- `illustManga`: (`Object`) 漫画和插画的搜索结果
|
||
- `total`: (`number`) 搜索结果总量
|
||
- `data`: (`Object[]`) 搜索结果(仅当前页数)
|
||
- `illustId`: (`string` -> `number`) 作品Id
|
||
- `illustTitle`: (`string`) 作品标题
|
||
- `id`: (`string` -> `number`) 与`illustId`一致, 猜测是以兼容旧版本为目录而存在
|
||
- `title`: (`string`) 与`illustTitle`一致, 猜测是以兼容旧版本为目录而存在
|
||
- `illustType`: (`number`) 作品类型
|
||
- `0`: 插画作品
|
||
- `1`: 漫画作品
|
||
- `2`: 动图作品
|
||
- `xRestrict`: (`number`) 作品是否为限制级, 基本准确, 少部分不一定(看Pixiv审核怎么理解了)
|
||
- `0`: 非限制级内容(即非R18作品)
|
||
- `1`: 限制级内容(即R18作品)
|
||
- `restrict`: (`number`) 作品限制级(意义不明, 可能是兼容性问题?)?
|
||
- `sl`: (`number`) 不明?
|
||
- `url`: (`string`) 作品预览图链接, 需要`Referer`请求头
|
||
- `description`: (`string`) 作品说明
|
||
- `tags`: (`string[]`) 作品标签数组
|
||
- `userId`: (`string` -> `number`) 作者用户Id
|
||
- `userName`: (`string`) 作者用户名
|
||
- `width`: (`number`) 作品长度
|
||
- `height`: (`number`) 作品高度
|
||
- `pageCount`: (`number`) 作品页数
|
||
- `isBookmarkable`: (`boolean`) 不明?
|
||
- `bookmarkData`: (`Unknown`) 不明?
|
||
- `alt`: (`string`) 简略介绍信息(在图片加载失败时可提供给`img`标签使用)
|
||
- `isAdContainer`: (`boolean`) 不明?
|
||
- `titleCaptionTranslation`: (`Object`) 不明?
|
||
- `workTitle`: (`Unknown`) 不明?
|
||
- `workCaption`: (`Unknown`) 不明?
|
||
- `createDate`: (`string`) 作品创建时间(或者是完成时间?)
|
||
- `updateDate`: (`string`) 作品上传时间
|
||
- `profileImageUrl`: (`string`) 作者用户头像图片链接
|
||
- `bookmarkRanges`: (`Object[]`) 收藏数范围(推测是用于按收藏数搜索而使用)
|
||
- `min`: (`number`) 最小收藏数, 值为 `null` 则无限制
|
||
- `max`: (`number`) 最大收藏数, 值为 `null` 则无限制
|
||
- `illust`: (`Object`) 插画作品搜索结果
|
||
- **与`illustManga`结构相同**
|
||
- `manga`: (`Object`) 漫画作品搜索结果
|
||
- **与`illustManga`结构相同**
|
||
- `novel`: (`Object`) 小说搜索结果
|
||
- **与`illustManga`结构相同**
|
||
- `popular`: (`Object`) 受欢迎的搜索结果
|
||
- `recent`: (`Object[]`) 近期推荐
|
||
- **与`illustManga.data.{element}`结构相同**
|
||
- `permanent`: (`Object[]`) 旧作品推荐
|
||
- **与`illustManga.data.{element}`结构相同**
|
||
- `relatedTags`: (`string[]`) 与搜索结果相关的原始标签名
|
||
- `tagTranslation`: (`Object`) 相关标签的翻译信息
|
||
- `{Attr: 标签名}`: 标签名为属性名, 对应 `relatedTags` 中的原始标签名
|
||
- `语言名(例如 中文是 zh)`: (`string`) 标签翻译名
|
||
- `zoneConfig`: (`Object`) 猜测是广告相关信息?
|
||
- `extraData`: (`Object`) 扩展信息
|
||
- `meta`: (`Object`) 网页元数据
|
||
- `title`: (`string`) 网页标题
|
||
- `description`: 搜索结果说明内容
|
||
- `descriptionHeader`: (`string`) 说明内容的Html代码
|
||
- `alternateLanguages`: (`Object`) 不明链接?
|
||
- `{语言名}`: 对应语言的链接
|
||
|
||
##### 请求 Url 中的 Type 与返回数据中属性的关系 #####
|
||
> 表中数据可能有错误，如发现问题，可在发起 Issue 并附上不在该表中情况（例如）的请求信息和返回数据，经确认后将会更新文档。
|
||
|
||
类型|illustManga|illust|manga|novel
|
||
:--|:-:|:-:|:-:|:-:
|
||
`artworks` |√|×|×|×
|
||
`top` |√|×|×|?
|
||
`illustrations`|×|√|×|×
|
||
`manga` |×|×|√|×
|
||
`novels` |×|×|×|√
|
||
|
||
符号解释:
|
||
- `√`: 该属性一定存在
|
||
- `?`: 该属性可能存在
|
||
- `×`: 该属性不存在
|