{
  "openapi": "3.0.1",
  "info": {
    "title": "Spotify Playlist Scraper - Every Track, Plays & Curators",
    "description": "Scrape Spotify playlists with every track: play counts, BPM, key, ISRC, genres and dates added. Find playlists by keyword with followers and curator contacts. Also tracks, albums, artists, podcasts, users, concerts and charts. No login needed.",
    "version": "0.0",
    "x-build-id": "MKDE0bH5IfqDZRW0i"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/clearpath~spotify-playlist-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-clearpath-spotify-playlist-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/clearpath~spotify-playlist-scraper/runs": {
      "post": {
        "operationId": "runs-sync-clearpath-spotify-playlist-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/clearpath~spotify-playlist-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-clearpath-spotify-playlist-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": {
          "urls": {
            "title": "Spotify links",
            "type": "array",
            "description": "Playlist, album, artist, track, podcast (show), episode, user profile or concert links. Also accepts <code>spotify:</code> URIs, <code>spotify.link</code> short links, localized links such as <code>open.spotify.com/intl-de/…</code> and bare 22-character IDs (read as <b>Type for bare IDs</b>).",
            "items": {
              "type": "string"
            }
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Keywords to search Spotify for, one per line, for example <code>lofi</code> or <code>indie rock 2026</code>. Each keyword returns up to 1,000 results per search type. A result found by several keywords is returned and charged once.",
            "items": {
              "type": "string"
            }
          },
          "searchTypes": {
            "title": "Search for",
            "type": "array",
            "description": "What to find for each search term. Playlists by default.",
            "items": {
              "type": "string",
              "enum": [
                "playlists",
                "tracks",
                "artists",
                "albums",
                "podcasts",
                "episodes",
                "users"
              ],
              "enumTitles": [
                "Playlists",
                "Tracks",
                "Artists",
                "Albums",
                "Podcasts",
                "Episodes",
                "Users (profiles)"
              ]
            },
            "default": [
              "playlists"
            ]
          },
          "maxResults": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many results to take for each search term and search type. Spotify returns at most 1,000 per keyword, which is the default.",
            "default": 1000
          },
          "maxItems": {
            "title": "Max results in total",
            "minimum": 1,
            "type": "integer",
            "description": "Stops the run after this many results across all links and searches. Leave empty for no limit. Each result is one dataset row and one charge; rows for links that could not be read are free."
          },
          "includeDetails": {
            "title": "Full details for search results",
            "type": "boolean",
            "description": "Fetch the full record of every search result at no extra charge: followers, track count and every track for playlists, monthly listeners and world rank for artists, play counts for tracks and albums. Turn off for a quicker list of names and links only.",
            "default": true
          },
          "maxTracksPerPlaylist": {
            "title": "Max tracks per playlist",
            "minimum": 0,
            "maximum": 20000,
            "type": "integer",
            "description": "How many tracks to return in each playlist. The default of 10,000 returns whole playlists; <code>trackCount</code> always shows the real total and <code>tracksComplete</code> tells you whether every track is there. Set 0 for playlist details only (followers, owner, contacts), which is fastest for finding playlists.",
            "default": 10000
          },
          "trackRows": {
            "title": "One row per playlist track",
            "type": "boolean",
            "description": "Return each playlist track as its own dataset row (with the playlist's ID, name and owner) instead of a list inside the playlist row. Best for spreadsheets and for playlists with thousands of tracks. Each track row counts as one result.",
            "default": false
          },
          "includeTrackInsights": {
            "title": "Track insights",
            "type": "boolean",
            "description": "Add to every playlist and album track: ISRC, popularity, audio preview link, Spotify's own genres, moods and activities, tempo (BPM), key and Camelot key. Adds a second or two per 500 tracks.",
            "default": true
          },
          "includeTrackCredits": {
            "title": "Track credits",
            "type": "boolean",
            "description": "Also add writers, producers, performers and the beats per bar to every playlist and album track. Single track links always include them. Makes playlist rows about a third larger.",
            "default": false
          },
          "minFollowers": {
            "title": "Min playlist followers",
            "minimum": 0,
            "type": "integer",
            "description": "Search only: skip playlists with fewer followers than this. Skipped playlists are never charged. 0 keeps every playlist.",
            "default": 0
          },
          "excludeSpotifyOwned": {
            "title": "Skip Spotify's own playlists",
            "type": "boolean",
            "description": "Search only: leave out editorial, chart and genre playlists made by Spotify, keeping playlists run by people, labels and brands.",
            "default": false
          },
          "excludePlaylistIds": {
            "title": "Playlists to skip",
            "type": "array",
            "description": "Search only: playlist links or IDs you already have. They are skipped and never charged. Paste the <code>id</code> column of an earlier run to get only new playlists.",
            "items": {
              "type": "string"
            }
          },
          "searchCountries": {
            "title": "Search in these countries",
            "type": "array",
            "description": "Repeat every search as if from these countries (two-letter codes such as <code>US</code>, <code>GB</code>, <code>DE</code>, <code>BR</code>). Spotify shows a different mix in each country, so each one usually adds new results. A result found in several countries is returned once; its <code>searchCountries</code> lists every country in which its <code>searchTerm</code> found it.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code for availability and for searches without a country list, for example <code>US</code>, <code>GB</code> or <code>DE</code>.",
            "default": "US"
          },
          "includeArtistAlbums": {
            "title": "Every release of an artist as its own row",
            "type": "boolean",
            "description": "For artist links: also return each album, single and compilation as its own album row with per-track play counts, ISRC and label. Each release row counts as one result. Artist rows already list every release in <code>albums</code>.",
            "default": false
          },
          "maxEpisodesPerShow": {
            "title": "Max episodes per podcast",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "How many episodes to list in each podcast (show) row, newest first. Set 0 for the show details only.",
            "default": 1000
          },
          "chartTypes": {
            "title": "Spotify weekly charts",
            "type": "array",
            "description": "Add Spotify's current global weekly top 50 charts, one row per chart position with rank and movement.",
            "items": {
              "type": "string",
              "enum": [
                "topSongs",
                "topAlbums",
                "topArtists"
              ],
              "enumTitles": [
                "Top songs (global, weekly)",
                "Top albums (global, weekly)",
                "Top artists (global, weekly)"
              ]
            }
          },
          "concertLocations": {
            "title": "Concerts near these places",
            "type": "array",
            "description": "Upcoming concerts Spotify lists near a place, one row per concert with venue, address, coordinates, lineup and ticket links. Enter <code>latitude,longitude</code> (for example <code>51.5072,-0.1276</code> for London) or a geohash. <b>Max results per search</b> caps the concerts per place.",
            "items": {
              "type": "string"
            }
          },
          "defaultType": {
            "title": "Type for bare IDs",
            "enum": [
              "playlist",
              "album",
              "artist",
              "track",
              "show",
              "episode",
              "user",
              "concert"
            ],
            "type": "string",
            "description": "How to read a 22-character ID that is not a link. Links and <code>spotify:</code> URIs always use their own type.",
            "default": "playlist"
          },
          "feedback": {
            "title": "Feedback to the maintainers",
            "type": "string",
            "description": "For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}