{ "openapi": "3.0.1", "info": { "title": "Spotify Monthly Listener Scraper", "description": "See any Spotify artist's monthly listeners, followers, world rank, top cities, top tracks with play counts, tour dates and bio. No Spotify login or API key needed. Great for tracking artist growth, scouting talent and music industry research.", "version": "1.0", "x-build-id": "hGtLrO81FjLaPiWua" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_wiki~spotify-monthly-listener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_wiki-spotify-monthly-listener", "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/data_wiki~spotify-monthly-listener/runs": { "post": { "operationId": "runs-sync-data_wiki-spotify-monthly-listener", "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/data_wiki~spotify-monthly-listener/run-sync": { "post": { "operationId": "run-sync-data_wiki-spotify-monthly-listener", "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", "required": [ "urls" ], "properties": { "urls": { "title": "🎤 Artists to scrape", "minItems": 1, "type": "array", "description": "One per line: a Spotify artist link (open.spotify.com/artist/...), a 22-character artist ID, a spotify:artist: URI or just the artist name (the best match is used). Duplicates are removed. Add as many as you like.", "items": { "type": "string" } }, "mode": { "title": "🧭 What to collect", "enum": [ "profile", "catalog", "similar" ], "type": "string", "description": "Profile: listeners, rank, top cities, top tracks and plays, tour dates, bio, socials (fastest). Catalog / Similar add releases or fans-also-like artists. You can also leave this on Profile and just type a number in 'Max similar artists' or 'Newest releases per artist' - those switch the extras on by themselves.", "default": "similar" }, "maxSimilarArtists": { "title": "🔗 Max similar artists (per input artist)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Add the artists Spotify says fans also like. Type a number above 0 to switch this on (no need to change the mode): that many extra artists are added for EACH artist you listed (the limit is per input, not shared). Spotify lists about 40 related artists per artist, so the Actor keeps following those lists until your number is reached. 0 = off (if you picked the similar-artists mode, 0 means each listed artist's full related list).", "default": 10 }, "maxReleasesPerArtist": { "title": "💿 Newest releases per artist", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Add each artist's newest releases with a play count for every track. Type a number above 0 to switch this on (no need to change the mode): that many of the newest releases are loaded per artist. 0 = off (if you picked the catalog mode, 0 means the whole catalog).", "default": 10 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Optional. By default requests go out without a proxy. If Spotify refuses them, the Actor switches to a datacenter proxy and then a residential proxy on its own and stays on it.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }