{ "openapi": "3.0.1", "info": { "title": "Spotify Catalog & Podcast Scraper", "description": "Scrape Spotify tracks, albums, artists, podcasts and episodes as clean JSON. Look up any Spotify URL or search by keyword for play counts, monthly listeners, followers, show ratings, episode descriptions and audio previews. No login, no API key.", "version": "0.1", "x-build-id": "xvyhLwIX514PeGQqe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~spotify-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-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/xtracto~spotify-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-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/xtracto~spotify-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-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": { "mode": { "title": "Mode", "enum": [ "detail", "search" ], "type": "string", "description": "What to do. 'detail' = look up each Spotify URL / URI and return the full track, album, artist, podcast show, episode, or playlist it points to (uses 'urls' / 'uris'). 'search' = find tracks, albums, artists, playlists, podcasts, or episodes by keyword (uses 'searchTerm' + 'searchTypes').", "default": "detail" }, "urls": { "title": "Spotify URLs", "type": "array", "description": "Used when mode = 'detail'. Full open.spotify.com links. Mix any track / album / artist / show (podcast) / episode / playlist URLs.", "items": { "type": "string" } }, "uris": { "title": "Spotify URIs (optional)", "type": "array", "description": "Optional alternative to 'urls' in 'detail' mode. Direct identifiers like 'spotify:track:69kOkLUCkxIZYexIgSG8rq'.", "items": { "type": "string" } }, "searchTerm": { "title": "Search term", "type": "string", "description": "Used when mode = 'search'. Free-text keyword (artist, track, show, etc.)." }, "searchTypes": { "title": "Search result types", "type": "array", "description": "Used when mode = 'search'. Which kinds of results to return.", "items": { "type": "string", "enum": [ "tracks", "albums", "artists", "playlists", "podcasts", "episodes" ], "enumTitles": [ "Tracks", "Albums", "Artists", "Playlists", "Podcasts", "Episodes" ] }, "default": [ "tracks" ] }, "limit": { "title": "Page size", "minimum": 1, "maximum": 50, "type": "integer", "description": "Results per request page (search results, album / playlist tracks). Max 50.", "default": 20 }, "offset": { "title": "Start offset", "minimum": 0, "type": "integer", "description": "Where to start paging from (search results, album / playlist tracks).", "default": 0 }, "maxItems": { "title": "Max records (0 = all)", "minimum": 0, "type": "integer", "description": "Maximum records to push to the dataset for the whole run (0 = no cap). Keyword search returns at most 1000 results per type.", "default": 100 }, "includeSSRPreview": { "title": "Include track audio preview URL", "type": "boolean", "description": "When on, each track in 'detail' mode is enriched with its 30-second audio preview URL.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Spotify catalog data is public and needs no proxy, so this is off by default. Enable it (Residential recommended) only if you want requests routed through Apify Proxy.", "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 } } } } } } } } } }