Kuaishou Music Chart Ranking

{
  "type": "object",
  "required": [
    "tab_id"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "default": 20,
      "description": "How many results to return, 1-50. Defaults to 20."
    },
    "tab_id": {
      "type": "integer",
      "description": "Which Kuaishou chart to fetch. 100002 is the hot-songs chart; 100063 is the recommendation chart."
    },
    "pcursor": {
      "type": "string",
      "description": "Pagination cursor. Leave blank on the first page; pass the previous response's pcursor value to fetch the next page."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "musics": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The track's id."
          },
          "name": {
            "type": "string",
            "description": "The song's title."
          },
          "type": {
            "type": "number",
            "description": "Track type code."
          },
          "artist": {
            "type": "string",
            "description": "The artist's name."
          },
          "chorus": {
            "type": "number",
            "description": "Chorus start offset in milliseconds. Absent on tracks without one."
          },
          "genreId": {
            "type": "number",
            "description": "Genre id; 0 observed on both charts."
          },
          "duration": {
            "type": "number",
            "description": "Track length in seconds."
          },
          "hotCount": {
            "type": "string",
            "description": "Popularity as a localized count string, e.g. \"1990.8万\" (roughly 19.9M)."
          },
          "loudness": {
            "type": "number",
            "description": "Loudness in dB (LUFS), a negative value."
          },
          "audioType": {
            "type": "number",
            "description": "Audio format/type code."
          },
          "isOffline": {
            "type": "boolean",
            "description": "Whether the track is currently offline/unavailable."
          },
          "artistName": {
            "type": "string",
            "description": "The artist's credited display name. Present on the hot-songs chart, absent on the recommendation chart."
          },
          "isOriginal": {
            "type": "boolean",
            "description": "Whether the track is an original piece. Present on some hot-songs tracks, absent on others."
          },
          "uploadTime": {
            "type": "number",
            "description": "Publish time as epoch milliseconds. Present on the hot-songs chart only."
          },
          "musicianUid": {
            "type": "number",
            "description": "The musician's numeric public account id."
          },
          "durationInfo": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "scene": {
                  "type": "number"
                },
                "product": {
                  "type": "string"
                },
                "durationShooting": {
                  "type": "number"
                },
                "durationPlayTrail": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "description": "Per-scene playback duration metadata. One entry per scene; product is a platform label, scene a code, and the two duration fields are measurements in milliseconds."
          },
          "hasCopyright": {
            "type": "boolean",
            "description": "Whether the platform holds playback rights to this track."
          },
          "vocalStartTime": {
            "type": "number",
            "description": "Vocal start offset in milliseconds; -1 observed when not set."
          },
          "snippetDuration": {
            "type": "number",
            "description": "Length of the playable snippet in seconds."
          },
          "licensedPlayScene": {
            "type": "array",
            "items": {
              "type": "number"
            },
            "description": "Scene codes this track is licensed for."
          },
          "copyrightTimeLimit": {
            "type": "number",
            "description": "Copyright-limited play window in seconds."
          }
        },
        "additionalProperties": true
      },
      "description": "The ranked songs, in chart order."
    },
    "result": {
      "type": "number",
      "description": "A result/status code; observed as 1 on both calibration charts."
    },
    "pcursor": {
      "type": "string",
      "description": "Pagination cursor. Pass it back as the input pcursor to fetch the next page."
    },
    "listTitleMessage": {
      "type": "string",
      "description": "Human-readable banner text for the chart, e.g. the date the chart was last updated."
    }
  },
  "description": "One music chart page, as returned at routing.responseResultPath ($.output): a chart-level banner, a pagination cursor, and the ranked list of songs. Every per-song field is optional -- some tracks omit some fields (e.g. no chorus offset, no original flag).",
  "additionalProperties": true
}