ContentGrabbingJi/documents/interfaces/Pixiv搜索接口.md

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): 最小收藏数 (该参数为会员限定功能，后续补充)

返回数据

数据示例

{
    "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	×	×	×	√

符号解释:

• √: 该属性一定存在
• ?: 该属性可能存在
• ×: 该属性不存在