{ "openapi": "3.0.1", "info": { "title": "SoundCloud Scraper — Music Data & Artist Emails", "description": "Scrape public SoundCloud tracks, artists, playlists, catalogs, and search results without cookies. Built for A&R, music research, outreach, monitoring, and AI workflows. Returns engagement metrics, ISRCs, tags, URLs, and publicly listed contact emails. No audio downloads or private data.", "version": "1.0", "x-build-id": "tgMwcBC6bhzU1wUvI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~soundcloud-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-soundcloud-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-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-soundcloud-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-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-soundcloud-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": { "mode": { "title": "Scraping Mode", "enum": [ "searchTracks", "searchArtists", "scrapeUrls", "artistTracks" ], "type": "string", "description": "Choose what the Actor should collect. Track and artist search use Search Queries; direct URL mode accepts tracks, artists, and playlists; artist catalog mode returns tracks from artist profile URLs. Search modes require the native SoundCloud route because the fallback provider does not expose search. The default is a track search that works as a health check.", "default": "searchTracks" }, "searchQueries": { "title": "Search Queries", "type": "array", "description": "Enter up to 20 SoundCloud search keywords or phrases. Each query is processed until the global Max Results limit is reached. This field is used only by Search tracks and Search artists. Try genres, moods, artists, labels, or track names.", "items": { "type": "string" }, "default": [ "lofi hip hop" ] }, "startUrls": { "title": "SoundCloud URLs", "type": "array", "description": "Add up to 50 public soundcloud.com URLs. Direct URL mode accepts track, artist, and playlist URLs; artist catalog mode accepts artist profile URLs only. Playlist URLs can produce one playlist row plus their track rows when expansion is enabled. Private, secret-token, and non-SoundCloud URLs are not supported.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "Public SoundCloud track, artist, or playlist URL." } }, "required": [ "url" ] }, "default": [ { "url": "https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean" } ] }, "maxResults": { "title": "Maximum Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Set the global maximum number of dataset rows and paid result events. The Actor stops across all queries and URLs when this cap is reached. A playlist row counts as one result, and each expanded track counts as another. Use a small value while testing cost and output shape.", "default": 25 }, "includeContactEmails": { "title": "Extract Public Contact Emails", "type": "boolean", "description": "Extract email addresses that artists publicly place in profile or track descriptions. This may make an extra public artist-profile request for track rows. The Actor never accesses private account information or guesses email addresses. Disable it when you only need catalog and engagement data.", "default": true }, "expandPlaylists": { "title": "Expand Playlist Tracks", "type": "boolean", "description": "When a playlist URL is resolved, save its track rows after the playlist row. Incomplete embedded tracks are hydrated through SoundCloud's public web API. All rows still obey the global result and cost cap. Disable this to return playlist metadata only.", "default": true }, "dataSource": { "title": "Data Source Strategy", "enum": [ "auto", "soundcloud", "scrapeCreators" ], "type": "string", "description": "Auto tries public SoundCloud web data first and uses the owner-managed ScrapeCreators fallback for supported direct track or artist routes. SoundCloud forces native extraction and never uses the paid fallback. ScrapeCreators forces the fallback and requires the Actor owner's configured secret. Search and playlist extraction are available only with Auto or SoundCloud.", "default": "auto" } } }, "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 } } }, "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 } } } } } } } } } }