{ "openapi": "3.0.1", "info": { "title": "Spotify Related Artists Scraper: Fans Also Like + Stats", "description": "Spotify 'Fans also like' related artists for any artist, with monthly listeners, followers and world rank for each. Crawl two levels deep and filter by listeners to find similar emerging artists.", "version": "1.0", "x-build-id": "ybzToW0fXrVHVDijw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eduair94~spotify-related-artists-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eduair94-spotify-related-artists-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/eduair94~spotify-related-artists-scraper/runs": { "post": { "operationId": "runs-sync-eduair94-spotify-related-artists-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/eduair94~spotify-related-artists-scraper/run-sync": { "post": { "operationId": "run-sync-eduair94-spotify-related-artists-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", "required": [ "artists" ], "properties": { "artists": { "title": "Artists", "minItems": 1, "type": "array", "description": "One artist per line: an open.spotify.com/artist/ link (spotify.link short links work too), a spotify:artist: URI, a 22-character artist ID, or an artist name such as Bad Bunny. A name is looked up with Spotify's artist search and only an artist named like it is used (case, accents, punctuation and small typos aside); a name that matches no artist is not charged. The same artist entered twice is read once.", "items": { "type": "string" } }, "maxRelatedPerArtist": { "title": "Max related artists per artist", "minimum": 1, "maximum": 40, "type": "integer", "description": "How many artists of each 'Fans also like' list to read, in Spotify's order (Spotify lists up to 40). Every one delivered is one result.", "default": 20 }, "depth": { "title": "Depth", "minimum": 1, "maximum": 2, "type": "integer", "description": "1: the related artists of your artists. 2: also the related artists of those (each artist's list read once per run; `viaArtistName` says whose list a row came from). Depth 2 returns up to Max related artists per artist squared for each of your artists.", "default": 1 }, "minMonthlyListeners": { "title": "Min monthly listeners", "minimum": 0, "type": "integer", "description": "Leave out related artists with fewer monthly listeners than this. Empty: no lower bound." }, "maxMonthlyListeners": { "title": "Max monthly listeners", "minimum": 0, "type": "integer", "description": "Leave out related artists with more monthly listeners than this (for example 100000 to find emerging artists). Empty: no upper bound." }, "excludeInputArtists": { "title": "Leave out my input artists", "type": "boolean", "description": "When one of your artists shows up in another one's related list, leave it out (it is not charged).", "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 } } } } } } } } } }