LamGC/ContentGrabbingJi
1
0
Fork 0
mirror of https://github.com/LamGC/ContentGrabbingJi.git synced 2025-04-30 06:37:36 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
792bfcb1bd
ContentGrabbingJi/documents/interfaces/Pixiv排行榜接口.md

6.4 KiB
Raw Blame History

Pixiv 排行榜获取接口

接口地址

GET https://www.pixiv.net/ranking.php
  • 是否需要登录: 是
  • 是否为Pixiv标准接口返回格式: 否
  • 是否需要Referer请求头: 否

参数

提示: 该接口参数较为复杂，请结合表格查看

  • date: 排行榜时间，与Mode有关 (格式: yyyy-MM-dd)
  • mode: 排行榜模式
    • daily: 每天
    • weekly: 每周
    • monthly: 每月
    • rookie: 新人
    • original: 原创
    • male: 男性偏好
    • female: 女性偏好
    • daily_r18: 每天 - 仅成人内容
    • weekly_r18: 每周 - 仅成人内容
    • male_r18: 男性偏好 - 仅成人内容
    • female_r18: 女性偏好 - 仅成人内容
  • content: 排行榜内容类型
    • all: 全部内容 (实际使用请直接省略content参数)
    • illust: 插画
    • ugoira: 动图
    • manga: 漫画
  • p: 排行榜页数 (如超出范围，则返回错误信息)
  • format: 格式
    • json: 以Json返回数据
    • (留空): 返回完整的排行榜网页

参数关系表

mode参数与content参数有一些支持关系，并不是所有的mode参数都能被所有的content参数支持，故附下表。

参数 all illust ugoira manga
daily √ √ √ √
weekly √ √ √ √
monthly √ √ × √
rookie √ √ × √
original √ × × ×
male √ × × ×
female √ × × ×
daily_r18 √ √ √ √
weekly_r18 √ √ √ √
male_r18 √ × × ×
female_r18 √ × × ×

返回数据

数据示例

{
    "contents":[
        {
            "title":"【伊アオ】髪結い。",
            "date":"2020年05月31日 14:26",
            "tags":[
                "鬼滅の刃",
                "伊アオ",
                "嘴平伊之助",
                "神崎アオイ",
                "鬼滅の刃1000users入り"
            ],
            "url":"https:\/\/i.pximg.net\/c\/240x480\/img-master\/img\/2020\/05\/31\/14\/26\/41\/81987309_p0_master1200.jpg",
            "illust_type":"0",
            "illust_book_style":"0",
            "illust_page_count":"1",
            "user_name":"シロウ",
            "profile_img":"https:\/\/i.pximg.net\/user-profile\/img\/2020\/05\/01\/02\/18\/18\/18450100_ac34872504959f8cc26f086248066b39_50.png",
            "illust_content_type":{
                "sexual":0,
                "lo":false,
                "grotesque":false,
                "violent":false,
                "homosexual":false,
                "drug":false,
                "thoughts":false,
                "antisocial":false,
                "religion":false,
                "original":false,
                "furry":false,
                "bl":false,
                "yuri":false
            },
            "illust_series":false,
            "illust_id":81987309,
            "width":600,
            "height":2226,
            "user_id":174995,
            "rank":51,
            "yes_rank":83,
            "rating_count":707,
            "view_count":19759,
            "illust_upload_timestamp":1590902801,
            "attr":"",
            "is_bookmarked":false,
            "bookmarkable":true
        }, // ....
    ],
    "mode":"daily",
    "content":"all",
    "page":2,
    "prev":1,
    "next":3,
    "date":"20200601",
    "prev_date":"20200531",
    "next_date":false,
    "rank_total":500
}

字段说明

  • contents: (Object[]) 排行榜数组, 最多50行排行榜信息
    • illust_id: (number) 作品Id
    • title: (string) 作品标题
    • attr: (string) 不明?
    • tags: (string[]) 原始标签数组
    • url: (string) 预览画质的原始尺寸图下载链接(存在防盗链)
    • illust_type: (string -> number) 作品类型
    • illust_book_style: (string -> number) 不明?
    • illust_page_count: (string -> number) 作品页数
    • user_name: (string) 画师用户名
    • user_id: (number) 画师用户Id
    • profile_img: (string) 画师用户头像
    • illust_content_type: (Object) 作品内容信息(警告: 文档内容仅作为开发参考, 并不传播相关内容!!!)
      • sexual: (number) 作品内容分级
        • 0: 全年龄
        • 1: 青少年
        • 2: 成人级
      • lo: (boolean) 是否为loli作品
      • grotesque: (boolean) 是否为怪诞作品
      • violent: (boolean) 作品是否含有暴力/强暴相关元素
      • homosexual: (boolean) 作品是否含有同性恋相关元素
      • drug: (boolean) 作品是否含有药物相关元素
      • thoughts: (boolean) 作品是否含有思维/记忆相关元素(这个属性翻译起来有些问题, 待纠正)?
      • antisocial: (boolean) 作品是否含有反社会, 令人厌恶的相关元素
      • religion: (boolean) 作品是否含有宗教, 信仰相关元素
      • original: (boolean) 作品是否为原创作品
      • furry: (boolean) 作品是否有兽人相关元素
      • bl: (boolean) 作品是否有耽美相关元素
      • yuri: (boolean) 作品是否有百合相关元素
    • illust_series: (boolean) 是否为系列作品
    • width: (number) 作品宽度(建议以原图为准)
    • height: (number) 作品高度(建议以原图为准)
    • rank: (number) 本期排行榜排名
    • yes_rank: (number) 上期同排行榜排名
    • rating_count:
    • view_count: (number) 浏览量
    • illust_upload_timestamp: (number) 作品上传时间戳(10位)
    • is_bookmarked: (boolean) 不明?
    • bookmarkable: (boolean) 不明?
  • mode: (string) 请求的排行榜模式字段
  • content: (string) 请求的内容类型
  • page: (number) 当前排行榜页数
  • prev: (string / boolean) 上一页排行榜页数, 如果该请求的页数为首页, 则为false
  • next: (string / boolean) 下一页排行榜页数, 如果该请求的页数为页尾, 则为false
  • date: (string) 排行榜日期(格式：yyyyMMdd)
  • prev_date: (string / boolean) 如果存在上一期排行榜, 则该属性为上期排行榜日期字符串, 否则为false
  • next_date: (string / boolean) 如果存在下一期排行榜, 则该属性为下期排行榜日期字符串, 否则为false
  • rank_total: (number) 该排行榜的总排行数