{
  "openapi": "3.0.1",
  "info": {
    "title": "Spotify Scraper — Artists, Tracks & Playlists",
    "description": "Scrape Spotify artists, albums, tracks, playlists, podcasts, episodes and search with play counts, monthly listeners and world rank. Full tracklists ride inside one result. No API key needed.",
    "version": "0.3",
    "x-build-id": "eDl5zKuEbYWY1KfuN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~spotify-all-in-one-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-spotify-all-in-one-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~spotify-all-in-one-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-spotify-all-in-one-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~spotify-all-in-one-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-spotify-all-in-one-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": {
          "spotifyUrls": {
            "title": "Spotify URLs, URIs, or IDs",
            "type": "array",
            "description": "Spotify references to scrape. Accepts full URLs (https://open.spotify.com/artist/3TVXtAsR1Inumwj472S9r4), URIs (spotify:album:4yP0hdKOZPNshxUOjY0cZj), or bare 22-character IDs. The entity type (artist, album, track, playlist, show, episode) is auto-detected from the URL/URI. For a bare ID, the type set in 'Default type for bare IDs' is used. This is NOT a keyword search box — put search terms in 'Search queries' instead.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Free-text keywords to search across Spotify (e.g. 'arctic monkeys' or 'true crime podcast'). Each query returns the top results of every type — artists, albums, tracks, playlists, shows, and episodes. Use 'Results per type' to control how many of each. Leave empty if you only want to scrape specific URLs.",
            "items": {
              "type": "string"
            }
          },
          "defaultType": {
            "title": "Default type for bare IDs",
            "enum": [
              "artist",
              "album",
              "track",
              "playlist",
              "show",
              "episode"
            ],
            "type": "string",
            "description": "Entity type assumed when an input is a bare 22-character Spotify ID with no URL/URI context. Ignored for full URLs and URIs (those carry their own type). Defaults to 'artist'.",
            "default": "artist"
          },
          "searchResultsPerType": {
            "title": "Search results per type",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "For keyword searches, how many results to return per result type (artists, albums, tracks, playlists, shows, episodes). For example, 5 returns up to 5 artists + 5 albums + 5 tracks, and so on. Range 1-50. Defaults to 5. Does not affect direct URL scraping.",
            "default": 5
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on the total number of result records produced (and billed) across the whole run. Each scraped entity or search-result item counts as one result. Use it to control cost. Defaults to 50. Free Apify plan runs are limited to 50.",
            "default": 50
          },
          "responseFormat": {
            "title": "Response format",
            "enum": [
              "concise",
              "detailed"
            ],
            "type": "string",
            "description": "'concise' returns the core record with the first 50 nested items (album tracks, playlist tracks, show episodes), ideal for AI agents and quick scans. 'detailed' pages through every nested item up to 'Max nested items' (up to 5000). Billing is identical (one charge per record); 'detailed' only adds run time. Defaults to 'concise'.",
            "default": "concise"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration (optional)",
            "type": "object",
            "description": "Optional. The Actor connects directly first and switches to Apify datacenter, then residential proxy only if Spotify blocks the direct connection. Set your own proxy here only if you need a specific one.",
            "default": {}
          },
          "searchTypes": {
            "title": "Search result types",
            "type": "array",
            "description": "Limit keyword search to these result types. Allowed values: artists, albums, tracks, playlists, shows, episodes. Leave empty to return every type.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxChildren": {
            "title": "Max nested items",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Cap on nested tracks or episodes inside one album, playlist or show record. Applies to both response formats. Range 1-5000. Defaults to 5000 (concise mode still returns the first 50).",
            "default": 5000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}