{ "openapi": "3.0.1", "info": { "title": "Spotify Scraper", "description": "Scrape Spotify tracks, artists, albums and playlists by keyword or URL. Get monthly listeners, followers, play counts, durations, release dates, popularity, images — plus ISRC and UPC codes for royalty matching and catalog work. Clean JSON, no API key. Pay only for results.", "version": "1.0", "x-build-id": "rGPiidEauIPuavW5Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~spotify-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-spotify-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/axlymxp~spotify-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-spotify-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/axlymxp~spotify-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-spotify-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": "Search queries", "type": "array", "description": "Keywords to search Spotify for, e.g. \"daft punk\", \"lo-fi beats\". Each query returns the top tracks/artists/albums/playlists (see Result types). Leave empty if you only pass Start URLs.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Direct Spotify links or URIs to scrape: track, artist, album or playlist. Accepts https://open.spotify.com/... URLs and spotify:track:... URIs. The type is detected automatically.", "items": { "type": "string" } }, "resultTypes": { "title": "Result types (search only)", "type": "array", "description": "Which entity types to keep from each search query. Ignored for Start URLs (their type is detected).", "items": { "type": "string", "enum": [ "tracks", "artists", "albums", "playlists" ], "enumTitles": [ "Tracks", "Artists", "Albums", "Playlists" ] }, "default": [ "tracks", "artists", "albums", "playlists" ] }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many top-level rows (each track/artist/album/playlist is one row).", "default": 100 }, "searchLimit": { "title": "Results per search section", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many items to take from each result type per search query (1–50).", "default": 20 }, "includeISRC": { "title": "Include ISRC / UPC codes", "type": "boolean", "description": "Enrich tracks with their ISRC code and popularity, and albums with their UPC code (one extra request per entity via Spotify's mobile backend). These industry identifiers are used for royalty matching and catalog reconciliation.", "default": true }, "includeAlbumTracks": { "title": "Include album tracklists", "type": "boolean", "description": "For albums, embed the full ordered tracklist (name, artists, duration, track number) inside the album row.", "default": false }, "includePlaylistTracks": { "title": "Include playlist tracks", "type": "boolean", "description": "For playlists, embed the tracks (up to the limit below) inside the playlist row. For large-scale playlist extraction use the dedicated Spotify Playlist Track Extractor.", "default": false }, "playlistTrackLimit": { "title": "Max playlist tracks per playlist", "minimum": 1, "maximum": 10000, "type": "integer", "description": "When 'Include playlist tracks' is on, cap embedded tracks per playlist.", "default": 100 }, "market": { "title": "Market (country code)", "type": "string", "description": "ISO 3166-1 alpha-2 market for availability/metadata, e.g. US, GB, DE.", "default": "US" }, "locale": { "title": "Locale", "type": "string", "description": "Language for text fields where available, e.g. en, es, de.", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify proxy. Spotify's endpoints work without a proxy; use one only if you need a specific egress region.", "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 } } }, "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 } } } } } } } } } }