Get a Category's Playlists with Spotify API

Pipedream makes it easy to connect APIs for Spotify and 2,400+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Get a Category's Playlists with the Spotify API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

Create a workflow to Get a Category's Playlists with the Spotify API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Get a Category's Playlists action
1. Connect your Spotify account
2. Select a Category ID
3. Optional- Select a Market
4. Optional- Configure Limit
5. Optional- Configure Offset
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Get a Category's Playlists with Spotify API on New Requests (Payload Only) from HTTP / Webhook API

HTTP / Webhook + Spotify

Try it

Get a Category's Playlists with Spotify API on New Item in Feed from RSS API

RSS + Spotify

Try it

Get a Category's Playlists with Spotify API on New Message from Discord API

Discord + Spotify

Try it

Get a Category's Playlists with Spotify API on New Message In Channels from Slack API

Slack + Spotify

Try it

Get a Category's Playlists with Spotify API on New Message in Channel from Discord Bot API

Discord Bot + Spotify

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Get a Category's Playlists on Spotify

Description:Get a list of Spotify playlists tagged with a particular category. [See the docs here](https://developer.spotify.com/documentation/web-api/reference/#/operations/get-a-categories-playlists).

Version:0.1.1

Key:spotify-get-categorys-playlist

View on GitHub

Code#

import { axios } from "@pipedream/platform";
import get from "lodash/get.js";
import spotify from "../../spotify.app.mjs";

export default {
  name: "Get a Category's Playlists",
  description: "Get a list of Spotify playlists tagged with a particular category. [See the docs here](https://developer.spotify.com/documentation/web-api/reference/#/operations/get-a-categories-playlists).",
  key: "spotify-get-categorys-playlist",
  version: "0.1.1",
  type: "action",
  props: {
    spotify,
    categoryId: {
      propDefinition: [
        spotify,
        "categoryId",
      ],
    },
    market: {
      propDefinition: [
        spotify,
        "market",
      ],
      optional: true,
    },
    limit: {
      propDefinition: [
        spotify,
        "limit",
      ],
      description: "The maximum number of items to return. Default: 20.",
      max: 50,
    },
    offset: {
      propDefinition: [
        spotify,
        "offset",
      ],
    },
  },
  async run({ $ }) {
    const {
      categoryId,
      market,
      limit,
      offset,
    } = this;

    const res = await axios($, this.spotify._getAxiosParams({
      method: "GET",
      path: `/browse/categories/${get(categoryId, "value", categoryId)}/playlists`,
      params: {
        limit,
        offset,
        country: market,
      },
    }));

    $.export("$summary", `Successfully fetched playlists for the "${get(categoryId, "label", categoryId)}" category`);

    return get(res, "playlists.items", []);
  },
};

Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Spotify	`spotify`	`app`	This component uses the Spotify app.
Category ID	`categoryId`	`string`	Select a value from the drop down menu.
Market	`market`	`string`	Select a value from the drop down menu:`{ "label": "Andorra", "value": "AD" }{ "label": "United Arab Emirates", "value": "AE" }{ "label": "Afghanistan", "value": "AF" }{ "label": "Antigua and Barbuda", "value": "AG" }{ "label": "Anguilla", "value": "AI" }{ "label": "Albania", "value": "AL" }{ "label": "Armenia", "value": "AM" }{ "label": "Angola", "value": "AO" }{ "label": "Antarctica", "value": "AQ" }{ "label": "Argentina", "value": "AR" }{ "label": "American Samoa", "value": "AS" }{ "label": "Austria", "value": "AT" }{ "label": "Australia", "value": "AU" }{ "label": "Aruba", "value": "AW" }{ "label": "Åland Islands", "value": "AX" }{ "label": "Azerbaijan", "value": "AZ" }{ "label": "Bosnia and Herzegovina", "value": "BA" }{ "label": "Barbados", "value": "BB" }{ "label": "Bangladesh", "value": "BD" }{ "label": "Belgium", "value": "BE" }{ "label": "Burkina Faso", "value": "BF" }{ "label": "Bulgaria", "value": "BG" }{ "label": "Bahrain", "value": "BH" }{ "label": "Burundi", "value": "BI" }{ "label": "Benin", "value": "BJ" }{ "label": "Saint Barthélemy", "value": "BL" }{ "label": "Bermuda", "value": "BM" }{ "label": "Brunei Darussalam", "value": "BN" }{ "label": "Bolivia (Plurinational State of)", "value": "BO" }{ "label": "Bonaire, Sint Eustatius and Saba", "value": "BQ" }{ "label": "Brazil", "value": "BR" }{ "label": "Bahamas", "value": "BS" }{ "label": "Bhutan", "value": "BT" }{ "label": "Bouvet Island", "value": "BV" }{ "label": "Botswana", "value": "BW" }{ "label": "Belarus", "value": "BY" }{ "label": "Belize", "value": "BZ" }{ "label": "Canada", "value": "CA" }{ "label": "Cocos (Keeling) Islands", "value": "CC" }{ "label": "Congo, Democratic Republic of the", "value": "CD" }{ "label": "Central African Republic", "value": "CF" }{ "label": "Congo", "value": "CG" }{ "label": "Switzerland", "value": "CH" }{ "label": "Côte d'Ivoire", "value": "CI" }{ "label": "Cook Islands", "value": "CK" }{ "label": "Chile", "value": "CL" }{ "label": "Cameroon", "value": "CM" }{ "label": "China", "value": "CN" }{ "label": "Colombia", "value": "CO" }{ "label": "Costa Rica", "value": "CR" }{ "label": "Cuba", "value": "CU" }{ "label": "Cabo Verde", "value": "CV" }{ "label": "Curaçao", "value": "CW" }{ "label": "Christmas Island", "value": "CX" }{ "label": "Cyprus", "value": "CY" }{ "label": "Czechia", "value": "CZ" }{ "label": "Germany", "value": "DE" }{ "label": "Djibouti", "value": "DJ" }{ "label": "Denmark", "value": "DK" }{ "label": "Dominica", "value": "DM" }{ "label": "Dominican Republic", "value": "DO" }{ "label": "Algeria", "value": "DZ" }{ "label": "Ecuador", "value": "EC" }{ "label": "Estonia", "value": "EE" }{ "label": "Egypt", "value": "EG" }{ "label": "Western Sahara", "value": "EH" }{ "label": "Eritrea", "value": "ER" }{ "label": "Spain", "value": "ES" }{ "label": "Ethiopia", "value": "ET" }{ "label": "Finland", "value": "FI" }{ "label": "Fiji", "value": "FJ" }{ "label": "Falkland Islands (Malvinas)", "value": "FK" }{ "label": "Micronesia (Federated States of)", "value": "FM" }{ "label": "Faroe Islands", "value": "FO" }{ "label": "France", "value": "FR" }{ "label": "Gabon", "value": "GA" }{ "label": "United Kingdom of Great Britain and Northern Ireland", "value": "GB" }{ "label": "Grenada", "value": "GD" }{ "label": "Georgia", "value": "GE" }{ "label": "French Guiana", "value": "GF" }{ "label": "Guernsey", "value": "GG" }{ "label": "Ghana", "value": "GH" }{ "label": "Gibraltar", "value": "GI" }{ "label": "Greenland", "value": "GL" }{ "label": "Gambia", "value": "GM" }{ "label": "Guinea", "value": "GN" }{ "label": "Guadeloupe", "value": "GP" }{ "label": "Equatorial Guinea", "value": "GQ" }{ "label": "Greece", "value": "GR" }{ "label": "South Georgia and the South Sandwich Islands", "value": "GS" }{ "label": "Guatemala", "value": "GT" }{ "label": "Guam", "value": "GU" }{ "label": "Guinea-Bissau", "value": "GW" }{ "label": "Guyana", "value": "GY" }{ "label": "Hong Kong", "value": "HK" }{ "label": "Heard Island and McDonald Islands", "value": "HM" }{ "label": "Honduras", "value": "HN" }{ "label": "Croatia", "value": "HR" }{ "label": "Haiti", "value": "HT" }{ "label": "Hungary", "value": "HU" }{ "label": "Indonesia", "value": "ID" }{ "label": "Ireland", "value": "IE" }{ "label": "Israel", "value": "IL" }{ "label": "Isle of Man", "value": "IM" }{ "label": "India", "value": "IN" }{ "label": "British Indian Ocean Territory", "value": "IO" }{ "label": "Iraq", "value": "IQ" }{ "label": "Iran (Islamic Republic of)", "value": "IR" }{ "label": "Iceland", "value": "IS" }{ "label": "Italy", "value": "IT" }{ "label": "Jersey", "value": "JE" }{ "label": "Jamaica", "value": "JM" }{ "label": "Jordan", "value": "JO" }{ "label": "Japan", "value": "JP" }{ "label": "Kenya", "value": "KE" }{ "label": "Kyrgyzstan", "value": "KG" }{ "label": "Cambodia", "value": "KH" }{ "label": "Kiribati", "value": "KI" }{ "label": "Comoros", "value": "KM" }{ "label": "Saint Kitts and Nevis", "value": "KN" }{ "label": "Korea (Democratic People's Republic of)", "value": "KP" }{ "label": "Korea, Republic of", "value": "KR" }{ "label": "Kuwait", "value": "KW" }{ "label": "Cayman Islands", "value": "KY" }{ "label": "Kazakhstan", "value": "KZ" }{ "label": "Lao People's Democratic Republic", "value": "LA" }{ "label": "Lebanon", "value": "LB" }{ "label": "Saint Lucia", "value": "LC" }{ "label": "Liechtenstein", "value": "LI" }{ "label": "Sri Lanka", "value": "LK" }{ "label": "Liberia", "value": "LR" }{ "label": "Lesotho", "value": "LS" }{ "label": "Lithuania", "value": "LT" }{ "label": "Luxembourg", "value": "LU" }{ "label": "Latvia", "value": "LV" }{ "label": "Libya", "value": "LY" }{ "label": "Morocco", "value": "MA" }{ "label": "Monaco", "value": "MC" }{ "label": "Moldova, Republic of", "value": "MD" }{ "label": "Montenegro", "value": "ME" }{ "label": "Saint Martin (French part)", "value": "MF" }{ "label": "Madagascar", "value": "MG" }{ "label": "Marshall Islands", "value": "MH" }{ "label": "North Macedonia", "value": "MK" }{ "label": "Mali", "value": "ML" }{ "label": "Myanmar", "value": "MM" }{ "label": "Mongolia", "value": "MN" }{ "label": "Macao", "value": "MO" }{ "label": "Northern Mariana Islands", "value": "MP" }{ "label": "Martinique", "value": "MQ" }{ "label": "Mauritania", "value": "MR" }{ "label": "Montserrat", "value": "MS" }{ "label": "Malta", "value": "MT" }{ "label": "Mauritius", "value": "MU" }{ "label": "Maldives", "value": "MV" }{ "label": "Malawi", "value": "MW" }{ "label": "Mexico", "value": "MX" }{ "label": "Malaysia", "value": "MY" }{ "label": "Mozambique", "value": "MZ" }{ "label": "Namibia", "value": "NA" }{ "label": "New Caledonia", "value": "NC" }{ "label": "Niger", "value": "NE" }{ "label": "Norfolk Island", "value": "NF" }{ "label": "Nigeria", "value": "NG" }{ "label": "Nicaragua", "value": "NI" }{ "label": "Netherlands", "value": "NL" }{ "label": "Norway", "value": "NO" }{ "label": "Nepal", "value": "NP" }{ "label": "Nauru", "value": "NR" }{ "label": "Niue", "value": "NU" }{ "label": "New Zealand", "value": "NZ" }{ "label": "Oman", "value": "OM" }{ "label": "Panama", "value": "PA" }{ "label": "Peru", "value": "PE" }{ "label": "French Polynesia", "value": "PF" }{ "label": "Papua New Guinea", "value": "PG" }{ "label": "Philippines", "value": "PH" }{ "label": "Pakistan", "value": "PK" }{ "label": "Poland", "value": "PL" }{ "label": "Saint Pierre and Miquelon", "value": "PM" }{ "label": "Pitcairn", "value": "PN" }{ "label": "Puerto Rico", "value": "PR" }{ "label": "Palestine, State of", "value": "PS" }{ "label": "Portugal", "value": "PT" }{ "label": "Palau", "value": "PW" }{ "label": "Paraguay", "value": "PY" }{ "label": "Qatar", "value": "QA" }{ "label": "Réunion", "value": "RE" }{ "label": "Romania", "value": "RO" }{ "label": "Serbia", "value": "RS" }{ "label": "Russian Federation", "value": "RU" }{ "label": "Rwanda", "value": "RW" }{ "label": "Saudi Arabia", "value": "SA" }{ "label": "Solomon Islands", "value": "SB" }{ "label": "Seychelles", "value": "SC" }{ "label": "Sudan", "value": "SD" }{ "label": "Sweden", "value": "SE" }{ "label": "Singapore", "value": "SG" }{ "label": "Saint Helena, Ascension and Tristan da Cunha", "value": "SH" }{ "label": "Slovenia", "value": "SI" }{ "label": "Svalbard and Jan Mayen", "value": "SJ" }{ "label": "Slovakia", "value": "SK" }{ "label": "Sierra Leone", "value": "SL" }{ "label": "San Marino", "value": "SM" }{ "label": "Senegal", "value": "SN" }{ "label": "Somalia", "value": "SO" }{ "label": "Suriname", "value": "SR" }{ "label": "South Sudan", "value": "SS" }{ "label": "Sao Tome and Principe", "value": "ST" }{ "label": "El Salvador", "value": "SV" }{ "label": "Sint Maarten (Dutch part)", "value": "SX" }{ "label": "Syrian Arab Republic", "value": "SY" }{ "label": "Eswatini", "value": "SZ" }{ "label": "Turks and Caicos Islands", "value": "TC" }{ "label": "Chad", "value": "TD" }{ "label": "French Southern Territories", "value": "TF" }{ "label": "Togo", "value": "TG" }{ "label": "Thailand", "value": "TH" }{ "label": "Tajikistan", "value": "TJ" }{ "label": "Tokelau", "value": "TK" }{ "label": "Timor-Leste", "value": "TL" }{ "label": "Turkmenistan", "value": "TM" }{ "label": "Tunisia", "value": "TN" }{ "label": "Tonga", "value": "TO" }{ "label": "Turkey", "value": "TR" }{ "label": "Trinidad and Tobago", "value": "TT" }{ "label": "Tuvalu", "value": "TV" }{ "label": "Taiwan, Province of China", "value": "TW" }{ "label": "Tanzania, United Republic of", "value": "TZ" }{ "label": "Ukraine", "value": "UA" }{ "label": "Uganda", "value": "UG" }{ "label": "United States Minor Outlying Islands", "value": "UM" }{ "label": "United States of America", "value": "US" }{ "label": "Uruguay", "value": "UY" }{ "label": "Uzbekistan", "value": "UZ" }{ "label": "Holy See", "value": "VA" }{ "label": "Saint Vincent and the Grenadines", "value": "VC" }{ "label": "Venezuela (Bolivarian Republic of)", "value": "VE" }{ "label": "Virgin Islands (British)", "value": "VG" }{ "label": "Virgin Islands (U.S.)", "value": "VI" }{ "label": "Viet Nam", "value": "VN" }{ "label": "Vanuatu", "value": "VU" }{ "label": "Wallis and Futuna", "value": "WF" }{ "label": "Samoa", "value": "WS" }{ "label": "Yemen", "value": "YE" }{ "label": "Mayotte", "value": "YT" }{ "label": "South Africa", "value": "ZA" }{ "label": "Zambia", "value": "ZM" }{ "label": "Zimbabwe", "value": "ZW" }`
Limit	`limit`	`integer`	The maximum number of items to return. Default: 20.
Offset	`offset`	`integer`	The index of the first item to return. Default: 0 (the first object). Use with `limit` to get the next set of items.

Authentication#

Spotify uses OAuth authentication. When you connect your Spotify account, Pipedream will open a popup window where you can sign into Spotify and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Spotify API.

Pipedream requests the following authorization scopes when you connect your account:

playlist-read-collaborativeplaylist-modify-privateplaylist-modify-publicplaylist-read-privateuser-modify-playback-stateuser-read-currently-playinguser-read-playback-stateuser-read-privateuser-read-emailuser-library-modifyuser-library-readuser-follow-modifyuser-follow-readuser-read-recently-playeduser-top-readstreamingapp-remote-controlugc-image-uploaduser-read-playback-position