{ "openapi": "3.0.1", "info": { "title": "Spotify Curator & Playlist Owner Profiler", "description": "Find the curators behind Spotify playlists in any niche and profile them: how many playlists they run, total follower reach, the artists they favour, how underground their picks are and whether they are still active. No Spotify account or API key.", "version": "0.0", "x-build-id": "arY0vtttyr9aaKtNi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~spotify-curator-profiler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-spotify-curator-profiler", "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-curator-profiler/runs": { "post": { "operationId": "runs-sync-fanndev-spotify-curator-profiler", "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-curator-profiler/run-sync": { "post": { "operationId": "run-sync-fanndev-spotify-curator-profiler", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Genres, moods or scenes to find curators in - 'indie folk', 'lofi study', 'afrobeats 2026', 'dangdut koplo'. Spotify returns at most 30 mixed results per keyword and ignores paging entirely, so coverage comes from using more keywords, not from asking for more per keyword. Results are also biased by the exit IP's country.", "items": { "type": "string" } }, "playlistUrls": { "title": "Playlist URLs", "type": "array", "description": "Specific playlists whose owners you want profiled. Share links, spotify:playlist: URIs and bare playlist ids all work.", "items": { "type": "string" } }, "startUrls": { "title": "Playlist URLs (request list)", "type": "array", "description": "The same playlist 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" } } } }, "trackSampleSize": { "title": "Tracks sampled per playlist", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many tracks to read from each playlist in order to describe the curator's taste. The sample costs nothing extra - the tracks arrive in the same request as the playlist's follower count. Set it to 0 to skip taste profiling and keep only reach numbers.", "default": 50 }, "maxPlaylistsPerKeyword": { "title": "Maximum playlists per keyword", "minimum": 1, "maximum": 30, "type": "integer", "description": "Cap on how many of each keyword's playlist results to profile. Spotify never returns more than 30 results of all types combined, so values above roughly 20 rarely change anything.", "default": 15 }, "maxPlaylists": { "title": "Maximum playlists in total", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Overall ceiling across every keyword and URL, after de-duplication. Each playlist costs one request.", "default": 200 }, "minFollowers": { "title": "Minimum playlist followers", "minimum": 0, "type": "integer", "description": "Skip playlists below this follower count. Useful for filtering out the long tail of personal playlists when you are looking for curators worth pitching to.", "default": 0 }, "includeEditorialPlaylists": { "title": "Include Spotify's own editorial playlists", "type": "boolean", "description": "Off by default. Spotify's editorial account owns the largest playlists in almost every niche, so leaving it in means 'Spotify' tops every ranking - true, but useless if you are looking for independent curators to approach. Turn it on when you want the editorial benchmark alongside them.", "default": false }, "emitPlaylistRecords": { "title": "Also emit one row per playlist", "type": "boolean", "description": "Write each profiled playlist as its own PLAYLIST row alongside the CURATOR rows: name, description, followers, track count, last update and owner.", "default": true }, "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: neither endpoint has a WAF or an IP block. It does change one thing - search results are geo-biased, so an exit IP in the market you care about surfaces local curators that a default one will not.", "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 } } } } } } } } } }