{ "openapi": "3.0.1", "info": { "title": "Spotify Scraper: Monthly Listeners, Playlists & Tracks", "description": "Get Spotify artists' monthly listeners, followers, top cities and top tracks, plus playlists with followers and track play counts, from links or search. $0.0035 per profile or direct track: 100 cost $0.35. Optional collection tracks $0.001 each. No login. Daily change monitoring.", "version": "1.0", "x-build-id": "9bG81S2h4klYunnBI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vant47~spotify-artist-playlist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vant47-spotify-artist-playlist-scraper", "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/vant47~spotify-artist-playlist-scraper/runs": { "post": { "operationId": "runs-sync-vant47-spotify-artist-playlist-scraper", "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/vant47~spotify-artist-playlist-scraper/run-sync": { "post": { "operationId": "run-sync-vant47-spotify-artist-playlist-scraper", "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": { "startUrls": { "title": "Spotify links", "type": "array", "description": "Public artist, playlist, album or track links. Canonical, intl locale and embed URLs are accepted. No private playlists, short links, login or account cookies. Artist profiles cost $0.0035 each before plan discounts. Direct track lookups also cost $0.0035 before discounts.", "items": { "type": "string" } }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Names or keywords, for example Coldplay or ambient. Search results receive full detail enrichment, including listener or play counts when supplied. At most 50 terms. Can be combined with links. Up to the first 1,000 ranked source results per term are considered, within maxItems.", "items": { "type": "string" } }, "searchType": { "title": "Search for", "enum": [ "artist", "playlist", "track", "album" ], "type": "string", "description": "The kind of public music result to search for. Direct links retain their own type.", "default": "artist" }, "maxItems": { "title": "Maximum music records", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Total unique charged artist, playlist, album and track rows across the entire run. Parent rows and includeTracks rows share this limit. Free notes and SUMMARY are additional. 100 profiles cost $0.35 before discounts and the small start fee. Increase the run timeout for large jobs: direct lookups are paced and thousands can take hours.", "default": 100 }, "includeTracks": { "title": "Include playlist and album tracks", "type": "boolean", "description": "Deliver separate track rows at $0.001 each before discounts. Playlist tracks receive full play-count enrichment. Album tracks include the source album context. Pagination continues until maxItems or the spending limit. Artist topTracks are always included inside the artist price.", "default": false }, "includeTopCities": { "title": "Include artist top cities", "type": "boolean", "description": "Include the city, country and listener count when the public artist source provides them. Otherwise null.", "default": true }, "onlyChangedSinceLastRun": { "title": "Only changed artist and playlist profiles", "type": "boolean", "description": "Use a stable watchId for sequential runs. First run delivers a baseline. Later runs deliver only artists whose monthly listeners or followers changed and playlists whose followers changed. Unchanged profiles have no profile charge. Albums and tracks are always delivered. Track edits alone do not make a playlist changed.", "default": false }, "watchId": { "title": "Watch ID", "type": "string", "description": "Required for change monitoring. Use a stable name of 1 to 80 letters, digits, underscores or hyphens. Different IDs keep separate baselines. Keep runs sequential. An unfinished run blocks this watch until resumed or a new ID is chosen." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Cloud datacenter access without an added proxy passed testing. Enable Apify datacenter proxy if your route is refused. Residential is optional and can increase platform costs. No outside service or account credential is required.", "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 } } } } } } } } } }