{ "openapi": "3.0.1", "info": { "title": "Spotify Artist Analytics & Monthly Listeners Tracker", "description": "Track any Spotify artist's monthly listeners, followers and top-5 listener cities over time, with per-run growth deltas. Also returns top tracks with lifetime play counts, the playlists driving discovery, upcoming concerts and social links. No Spotify account or API key needed.", "version": "0.0", "x-build-id": "QKvgwXwPa1RE1SZpv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~spotify-artist-analytics-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-spotify-artist-analytics-tracker", "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/fanndev~spotify-artist-analytics-tracker/runs": { "post": { "operationId": "runs-sync-fanndev-spotify-artist-analytics-tracker", "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/fanndev~spotify-artist-analytics-tracker/run-sync": { "post": { "operationId": "run-sync-fanndev-spotify-artist-analytics-tracker", "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": { "artistUrls": { "title": "Artist URLs", "type": "array", "description": "Spotify artists to read. Share links, /intl-xx/ localised links, spotify:artist: URIs and bare artist ids all work.", "items": { "type": "string" } }, "artistNames": { "title": "Artist names", "type": "array", "description": "Artists to look up by name instead of by link, one per line. Each name costs one extra search request and the run logs which artist it matched, so check the log when a name is ambiguous.", "items": { "type": "string" } }, "startUrls": { "title": "Artist URLs (request list)", "type": "array", "description": "The same artist links, in the request-list format, for callers that already keep one.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "trackChanges": { "title": "Report growth since the previous run", "type": "boolean", "description": "Remember this run's numbers and report the change next time: absolute delta, percentage, a per-day rate and an up/down/flat trend for monthly listeners, followers and the top track's play count. The first run has nothing to compare against and is marked isFirstReading.", "default": true }, "trackingStoreName": { "title": "Tracking store name", "type": "string", "description": "Named key-value store that holds the previous reading. Scheduled runs pointed at the same name build one history; use different names to keep separate watchlists apart.", "default": "spotify-artist-analytics" }, "includeTopTracks": { "title": "Include top tracks", "type": "boolean", "description": "Attach the artist's ten most-played tracks, each with its lifetime play count, as a nested field on the artist record.", "default": true }, "emitTopTrackRows": { "title": "Also emit one row per top track", "type": "boolean", "description": "Write each top track as its own TOP_TRACK dataset row as well. Handy for spreadsheets, since nested fields flatten badly into CSV.", "default": false }, "includeDiscovery": { "title": "Include discovery playlists and related artists", "type": "boolean", "description": "Attach the playlists Spotify says the artist is being discovered on - the most actionable list on the page for an artist team - plus the playlists featuring them and the artists Spotify considers similar.", "default": true }, "includeConcerts": { "title": "Include upcoming concerts", "type": "boolean", "description": "Attach the upcoming dates Spotify lists for the artist, with venue, city and whether it is a festival.", "default": true }, "maxArtists": { "title": "Maximum artists", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Ceiling on how many artists a single run reads, so an oversized watchlist cannot run away.", "default": 200 }, "exportFormats": { "title": "Extra export files", "type": "array", "description": "Besides the dataset, write ready-made files into this run's key-value store.", "items": { "type": "string", "enum": [ "json", "ndjson", "csv", "excel" ], "enumTitles": [ "JSON", "NDJSON", "CSV", "Excel (XLSX)" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default and genuinely optional: the endpoint this actor reads has no WAF and no IP block, so the platform's own address reaches it. Turn it on only for very large watchlists.", "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 } } } } } } } } } }