{ "openapi": "3.0.1", "info": { "title": "Spotify Monthly Listeners & Followers Tracker - Exact Counts", "description": "Monthly listeners and followers for any Spotify artist as the exact integers on the public artist page, plus the top tracks with play counts and the latest release. Turn monitoring on and later runs return an artist only when a count has moved.", "version": "0.1", "x-build-id": "Zi60ScaeAVkTRKnI2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~spotify-monthly-listeners-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-spotify-monthly-listeners-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/neverempty~spotify-monthly-listeners-tracker/runs": { "post": { "operationId": "runs-sync-neverempty-spotify-monthly-listeners-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/neverempty~spotify-monthly-listeners-tracker/run-sync": { "post": { "operationId": "run-sync-neverempty-spotify-monthly-listeners-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": { "artists": { "title": "Spotify artists", "type": "array", "description": "Artist page URLs (https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02), spotify:artist: URIs, or the 22-character artist IDs. Only open.spotify.com/artist/ pages are requested. A track, album or playlist link is rejected rather than guessed, and an ID Spotify has no page for comes back as a \"no-such-artist\" row that is not charged. Artist names are not searched: use the link from the Share menu in Spotify.", "items": { "type": "string" } }, "maxArtists": { "title": "Maximum artists to return", "minimum": 1, "maximum": 1000, "type": "integer", "description": "With monitoring off, the run stops after this many artist rows and lists the lines it did not read in a row that is not charged. Monitoring mode ignores this and checks every artist you listed.", "default": 100 }, "monitoringMode": { "title": "Monitoring mode: return an artist only when a count has moved", "type": "boolean", "description": "Off = return every artist you listed, charged per artist row. On = the counts are remembered and later runs return an artist only when its monthly listeners or followers differ from the remembered figure, together with the previous figure and the difference. In monitoring mode each artist that was read is charged as one check (artist-checked), and an artist that is returned is also charged as one artist row (artist-returned). The first monitoring run returns every artist once. Counts are remembered per artist, not per list, so adding an artist does not return the others again. Do not put the same artist in two schedules that run at the same moment.", "default": false }, "monitorMode": { "title": "What counts as a change", "enum": [ "any-change", "listeners-change", "followers-change" ], "type": "string", "description": "Any change = the artist is returned when monthly listeners or followers differ from the remembered figure. The other two options watch only one of the two numbers. Top-track play counts are reported in every returned row but do not trigger a return on their own.", "default": "any-change" }, "resetMonitoringState": { "title": "Forget the remembered counts and start over", "type": "boolean", "description": "Clears every remembered count for this Actor on your account, so the next monitoring run returns each artist once again. This affects all your monitoring runs, because counts are remembered per artist rather than per list.", "default": false }, "useProxy": { "title": "Retry once through a residential proxy when Spotify answers 403 or 429", "type": "boolean", "description": "Requests go directly to Spotify. If Spotify answers HTTP 403 or 429, the page is requested one more time through an Apify residential proxy and, if it is refused again, the run stops asking and lists what it did not read. Turn this off to never use a proxy.", "default": true } } }, "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 } } } } } } } } } }