{ "openapi": "3.0.1", "info": { "title": "SoundCloud Artists Scraper — Emails & Socials", "description": "SoundCloud artist leads with booking emails, from $1.40 per 1,000 artists (running cost extra). Find producers, DJs and bands by keyword, city or follower range, or the followers of any artist. Bio emails, social links. No login.", "version": "0.1", "x-build-id": "xTYprF3iOBtOkKhzG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~soundcloud-artists-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-soundcloud-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/khadinakbar~soundcloud-artists-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-soundcloud-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/khadinakbar~soundcloud-artists-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-soundcloud-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", "properties": { "searchQueries": { "title": "Artist search queries", "type": "array", "description": "Keywords for finding artists, labels, DJs, producers or genres, for example techno producer or Berlin DJ. Results from all queries are combined and de-duplicated. Leave empty when you only use links or followers. If you give no source at all, the example search electronic music runs.", "items": { "type": "string" } }, "artistUrls": { "title": "SoundCloud links or artist handles", "type": "array", "description": "Artist profile links, bare handles (monstercat), or track, playlist and album links. A track or playlist link returns the artist who uploaded it. One per line.", "items": { "type": "string" } }, "followersOf": { "title": "Find artists who follow these artists", "type": "array", "description": "Artist profile links or handles (up to 20). The Actor reads their followers and returns the ones that pass your filters. Good for finding fans who are producers themselves, or smaller artists in the same scene.", "items": { "type": "string" } }, "followingsOf": { "title": "Find artists these artists follow", "type": "array", "description": "Artist profile links or handles (up to 20). The Actor reads who they follow and returns the ones that pass your filters. Good for mapping an artist's circle, label roster or collaborators.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum artists", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of unique artists to save across all sources. You pay only for saved artists.", "default": 25 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "maximum": 2147483647, "type": "integer", "description": "Keep artists with at least this many followers. 0 turns the filter off.", "default": 0 }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "maximum": 2147483647, "type": "integer", "description": "Keep artists with at most this many followers, to find small or emerging artists. 0 means no upper limit.", "default": 0 }, "countryCodes": { "title": "Country codes", "type": "array", "description": "Two-letter country codes such as US, GB, DE or CA. Artists without a matching public country are left out.", "items": { "type": "string", "pattern": "^[A-Za-z]{2}$" } }, "cities": { "title": "Cities", "type": "array", "description": "City names such as Berlin or Los Angeles. Matching ignores upper/lower case and accents. Artists without a matching public city are left out.", "items": { "type": "string" } }, "verifiedOnly": { "title": "Verified artists only", "type": "boolean", "description": "Keep only SoundCloud-verified profiles.", "default": false }, "requireEmail": { "title": "Require a public bio email", "type": "boolean", "description": "Keep only artists whose public bio contains at least one email address.", "default": false }, "activeWithinDays": { "title": "Released something in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Keep only artists whose newest public upload is at most this many days old, for example 180. 0 turns the filter off. Turning it on also fills the latest-release fields.", "default": 0 }, "includeWebProfiles": { "title": "Include social and website links", "type": "boolean", "description": "Add the artist's connected public links, grouped as Instagram, X/Twitter, Facebook, YouTube, Spotify, websites or other profiles.", "default": true }, "includeLatestRelease": { "title": "Include latest release", "type": "boolean", "description": "Add the date, title and link of the artist's newest public upload. Makes one extra request per saved artist; the price per artist stays the same.", "default": false }, "findWebsiteEmails": { "title": "Find emails on artists' websites", "type": "boolean", "description": "Starts on 24 November 2026 and does nothing before then. Reads the public contact pages of the website an artist lists on their SoundCloud profile (robots.txt respected, no logins, at most 4 pages per site) and returns the emails it finds. Extra price only when an email is found, per artist: Free $0.003, Bronze $0.0027, Silver $0.0024, Gold and up $0.002. Artists with no email found cost nothing extra.", "default": 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 } } } } } } } } } }