{ "openapi": "3.0.1", "info": { "title": "China Music Charts: NetEase, QQ Music & Kugou Top Songs", "description": "China's music charts in one dataset, no login: NetEase Cloud Music (65 charts), QQ Music (30) and Kugou (33) with rank, rank change, song, artists, album, duration and release date. Soaring, hot, new songs, TOP500, regional and genre charts.", "version": "1.0", "x-build-id": "C86ed5CHypWvq815y" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sinodata~china-music-charts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sinodata-china-music-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sinodata~china-music-charts/runs": { "post": { "operationId": "runs-sync-sinodata-china-music-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sinodata~china-music-charts/run-sync": { "post": { "operationId": "run-sync-sinodata-china-music-charts", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "platforms": { "title": "Platforms", "type": "array", "description": "Which music platforms to read.", "items": { "type": "string", "enum": [ "netease", "qq", "kugou" ], "enumTitles": [ "NetEase Cloud Music (网易云音乐)", "QQ Music (QQ音乐)", "Kugou (酷狗音乐)" ] }, "default": [ "netease", "qq", "kugou" ] }, "charts": { "title": "Charts", "type": "array", "description": "Optional: chart names (part of the name is enough, e.g. 飙升榜, 热歌榜, 新歌榜, 说唱, 欧美, 抖音) or chart IDs. Leave empty for each platform's main charts (soaring, hot and new songs).", "items": { "type": "string" } }, "allCharts": { "title": "All charts", "type": "boolean", "description": "Every chart of the chosen platforms (about 130 in total).", "default": false }, "maxSongsPerChart": { "title": "Max songs per chart", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most charts have 100 songs; Kugou TOP500 has 500.", "default": 100 }, "listChartsOnly": { "title": "List charts only", "type": "boolean", "description": "Only list the available charts with their names and IDs (free).", "default": false }, "includeHotComments": { "title": "Hot comments for NetEase songs", "type": "boolean", "description": "Also save the hot comments (up to 15) of every NetEase chart song: text, likes, date and IP region. Commenters are not collected.", "default": false }, "commentSongs": { "title": "Comments for these NetEase songs", "type": "array", "description": "NetEase song links (music.163.com/#/song?id=…) or song IDs: hot comments first, then the newest. On its own, this returns only comments; add chart names to get charts too.", "items": { "type": "string" } }, "maxCommentsPerSong": { "title": "Max comments per song", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hot comments come first (up to 15), then the newest.", "default": 15 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }