Spotify


HOST
api.spotify.com

albums


Get Several Albums


Get Several Albums

Parameters

  • ids string Required

    A comma-separated list of IDs

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /albums
200 - OK
{
  "albums": [
    {
      "album_type": "string",
      "artists": [
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "copyrights": [
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        }
      ],
      "external_ids": {},
      "external_urls": {},
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "release_date": "string",
      "release_date_precision": "string",
      "tracks": {
        "href": "string",
        "items": [
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          }
        ],
        "limit": 123,
        "next": "string",
        "offset": 123,
        "previous": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "artists": [
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "copyrights": [
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        }
      ],
      "external_ids": {},
      "external_urls": {},
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "release_date": "string",
      "release_date_precision": "string",
      "tracks": {
        "href": "string",
        "items": [
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          }
        ],
        "limit": 123,
        "next": "string",
        "offset": 123,
        "previous": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "artists": [
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "genres": [
            {},
            {},
            {}
          ],
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "popularity": 123,
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "copyrights": [
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        }
      ],
      "external_ids": {},
      "external_urls": {},
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "release_date": "string",
      "release_date_precision": "string",
      "tracks": {
        "href": "string",
        "items": [
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          },
          {
            "artists": [
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              },
              {
                "external_urls": {},
                "href": "string",
                "id": "string",
                "name": "string",
                "type": "string",
                "uri": "string"
              }
            ],
            "available_markets": [
              {},
              {},
              {}
            ],
            "disc_number": 123,
            "duration_ms": 123,
            "explicit": true,
            "external_urls": {},
            "href": "string",
            "id": "string",
            "is_playable": true,
            "linked_from": {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "type": "string",
              "uri": "string"
            },
            "name": "string",
            "preview_url": "string",
            "track_number": 123,
            "type": "string",
            "uri": "string"
          }
        ],
        "limit": 123,
        "next": "string",
        "offset": 123,
        "previous": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    }
  ]
}

Get an Album


Get an Album

Parameters

  • id string Required

    The Spotify ID for the album

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /albums/{id}
200 - OK
{
  "album_type": "string",
  "artists": [
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    }
  ],
  "available_markets": [
    {},
    {},
    {}
  ],
  "copyrights": [
    {
      "text": "string",
      "type": "string"
    },
    {
      "text": "string",
      "type": "string"
    },
    {
      "text": "string",
      "type": "string"
    }
  ],
  "external_ids": {},
  "external_urls": {},
  "genres": [
    {},
    {},
    {}
  ],
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    }
  ],
  "name": "string",
  "popularity": 123,
  "release_date": "string",
  "release_date_precision": "string",
  "tracks": {
    "href": "string",
    "items": [
      {
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  },
  "type": "string",
  "uri": "string"
}

Get an Album's Tracks


Get an Album's Tracks

Parameters

  • id string Required

    The Spotify ID for the album

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /albums/{id}/tracks
200 - OK
{
  "href": "string",
  "items": [
    {
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}

artists


Get Several Artists


Get Several Artists

Parameters

  • ids string Required

    A comma-separated list of IDs

get - /artists
200 - OK
{
  "artists": [
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    }
  ]
}

Get an Artist


Get an Artist

Parameters

  • id string Required

    The Spotify ID for the artist

get - /artists/{id}
200 - OK
{
  "external_urls": {},
  "followers": {
    "href": "string",
    "total": 123
  },
  "genres": [
    {},
    {},
    {}
  ],
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    }
  ],
  "name": "string",
  "popularity": 123,
  "type": "string",
  "uri": "string"
}

Get an Artist's Albums


Get an Artist's Albums

Parameters

  • id string Required

    The Spotify ID for the artist

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • album_type string

    Filter by album types

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /artists/{id}/albums
200 - OK
{
  "href": "string",
  "items": [
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}

Get an Artist's Related Artists


Get an Artist's Related Artists

Parameters

  • id string Required

    The Spotify ID for the artist

get - /artists/{id}/related-artists
200 - OK
{
  "artists": [
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "followers": {
        "href": "string",
        "total": 123
      },
      "genres": [
        {},
        {},
        {}
      ],
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "popularity": 123,
      "type": "string",
      "uri": "string"
    }
  ]
}

Get an Artist's Top Tracks


Get an Artist's Top Tracks

Parameters

  • id string Required

    The Spotify ID for the artist

  • country string Required

    The country (an ISO 3166-1 alpha-2 country code)

get - /artists/{id}/top-tracks
200 - OK
{
  "tracks": [
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    }
  ]
}

browse


Get a List of Browse Categories


Get a List of Browse Categories

Parameters

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • country string

    The country (an ISO 3166-1 alpha-2 country code)

  • locale string

    The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)".

  • Accept string

    It is used to set specified media type.

get - /browse/categories
200 - OK
{
  "href": "string",
  "items": [
    {
      "href": "string",
      "icons": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "id": "string",
      "name": "string"
    },
    {
      "href": "string",
      "icons": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "id": "string",
      "name": "string"
    },
    {
      "href": "string",
      "icons": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "id": "string",
      "name": "string"
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a Single Browse Category


Get a Single Browse Category

Parameters

  • category_id string Required

    The Spotify ID of the category you wish to fetch.

  • country string

    The country (an ISO 3166-1 alpha-2 country code)

  • locale string

    The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)".

  • Accept string

    It is used to set specified media type.

get - /browse/categories/{category_id}
200 - OK
{
  "href": "string",
  "icons": [
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    }
  ],
  "id": "string",
  "name": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a Category's playlists


Get a Category's playlists

Parameters

  • category_id string Required

    The Spotify ID of the category you wish to fetch.

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • country string

    The country (an ISO 3166-1 alpha-2 country code)

  • Accept string

    It is used to set specified media type.

get - /browse/categories/{category_id}/playlists
200 - OK
{
  "playlists": {
    "href": "string",
    "items": [
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      },
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      },
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  }
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a List of Featured Playlists


Get a List of Featured Playlists

Parameters

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • country string

    The country (an ISO 3166-1 alpha-2 country code)

  • locale string

    The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore. For example: es_MX, meaning "Spanish (Mexico)".

  • timestamp string

    A timestamp in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss) with the user's local time to get results tailored to a specific date and time in the day. If not provided, it defaults to the current UTC time. Example: "2014-10-23T09:00:00" for a user whose local time is 9AM.

  • Accept string

    It is used to set specified media type.

get - /browse/featured-playlists
200 - OK
{
  "message": "string",
  "playlists": {
    "href": "string",
    "items": [
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      },
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      },
      {
        "collaborative": true,
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "owner": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "public": true,
        "snapshot_id": "string",
        "tracks": {
          "href": "string",
          "total": 123
        },
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  }
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a List of New Releases


Get a List of New Releases

Parameters

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • country string

    The country (an ISO 3166-1 alpha-2 country code)

  • Accept string

    It is used to set specified media type.

get - /browse/new-releases
200 - OK
{
  "href": "string",
  "items": [
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "album_type": "string",
      "available_markets": [
        {},
        {},
        {}
      ],
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

me


Get Current User's Profile


Get Current User's Profile

get - /me
200 - OK
{
  "birthdate": "string",
  "country": "string",
  "displayName": "string",
  "email": "string",
  "external_urls": {},
  "followers": {
    "href": "string",
    "total": 123
  },
  "href": "string",
  "id": "string",
  "product": "string",
  "type": "string",
  "uri": "string"
}

Unfollow Artists or Users


Unfollow Artists or Users

Parameters

  • type string Required

    The type to unfollow.

  • ids string Required

    A comma-separated list of the artists or users ids

delete - /me/following
204 - No Content

Get User's Followed Artists


Get User's Followed Artists

Parameters

  • type string Required

    The ID type, currently only artist is supported.

  • limit integer

    The maximum number of items to return

  • after string

    The last artist ID retrieved from the previous request.

get - /me/following
200 - OK
{
  "artists": {
    "cursor": {
      "after": "string"
    },
    "href": "string",
    "items": [
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "total": 123
  }
}

Follow Artists or Users


Follow Artists or Users

Parameters

  • type string Required

    The type to follow.

  • ids string Required

    A comma-separated list of the artists or users ids

put - /me/following
204 - No Content

Check if Current User Follows Artists or Users


Check if Current User Follows Artists or Users

Parameters

  • type string Required

    The type to follow.

  • ids string Required

    A comma-separated string of the artists or users ids.

get - /me/following/contains
200 - OK
{}

Remove Tracks for Current User


Remove Tracks for Current User

Parameters

  • ids string Required

    A comma-separated list of IDs

  • Accept string

    It is used to set specified media type.

delete - /me/tracks
200 - OK
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get Current User's Saved Tracks


Get Current User's Saved Tracks

Parameters

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

  • Accept string

    It is used to set specified media type.

get - /me/tracks
200 - OK
{
  "href": "string",
  "items": [
    {
      "added_at": "string",
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    },
    {
      "added_at": "string",
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    },
    {
      "added_at": "string",
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Save Tracks for Current User


Save Tracks for Current User

Parameters

  • ids string Required

    A comma-separated list of IDs

  • Accept string

    It is used to set specified media type.

put - /me/tracks
200 - OK
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Check Current User's Saved Tracks


Check Current User's Saved Tracks

Parameters

  • ids string Required

    A comma-separated list of IDs

get - /me/tracks/contains
200 - OK
{}

Search for an Item


Search for an Item

Parameters

  • q string Required

    The search query's keywords (and optional field filters). The search is not case-sensitive: 'roadhouse' will match 'Roadhouse', 'roadHouse', etc. Keywords will be matched in any order unless surrounded by quotes, thus q=roadhouse&20blues will match both 'Blues Roadhouse' and 'Roadhouse of the Blues'. Quotation marks can be used to limit the match to a phrase: q=roadhouse&20blues will match 'My Roadhouse Blues' but not 'Roadhouse of the Blues'. By default, results are returned when a match is found in any field of the target object type. Searches can be made more specific by specifying an album, artist or track field filter. For example q=album:gold%20artist:abba&type=album will search for albums with the text 'gold' in the album name and the text 'abba' in an artist name. Other possible field filters, depending on object types being searched, include year, genre, upc, and isrc. For example, q=damian%20genre:reggae-pop&type=artist. The asterisk (*) character can, with some limitations, be used as a wildcard (maximum: 2 per query). It will match a variable number of non-white-space characters. It cannot be used in a quoted phrase, in a field filter, or as the first character of the keyword string. Searching for playlists will return results matching the playlist's name and/or description.

  • type string Required

    A comma-separated list of item types to search across. Search results will include hits from all the specified item types; for example q=name:abacab&type=album,track will return both albums and tracks with "abacab" in their name.

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • market string

    The market (an ISO 3166-1 alpha-2 country code). If given, only items with content playable in that market will be returned.

get - /search
200 - OK
{
  "albums": {
    "href": "string",
    "items": [
      {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  },
  "artists": {
    "href": "string",
    "items": [
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "genres": [
          {},
          {},
          {}
        ],
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "popularity": 123,
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  },
  "tracks": {
    "href": "string",
    "items": [
      {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      },
      {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  }
}

tracks


Get Several Tracks


Get Several Tracks

Parameters

  • ids string Required

    A comma-separated list of IDs

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /tracks
200 - OK
{
  "tracks": [
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    },
    {
      "album": {
        "album_type": "string",
        "available_markets": [
          {},
          {},
          {}
        ],
        "external_urls": {},
        "href": "string",
        "id": "string",
        "images": [
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          },
          {
            "height": 123,
            "url": "string",
            "width": 123
          }
        ],
        "name": "string",
        "type": "string",
        "uri": "string"
      },
      "artists": [
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "name": "string",
          "type": "string",
          "uri": "string"
        }
      ],
      "available_markets": [
        {},
        {},
        {}
      ],
      "disc_number": 123,
      "duration_ms": 123,
      "explicit": true,
      "external_ids": {},
      "external_urls": {},
      "href": "string",
      "id": "string",
      "is_playable": true,
      "linked_from": {
        "external_urls": {},
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "name": "string",
      "preview_url": "string",
      "track_number": 123,
      "type": "string",
      "uri": "string"
    }
  ]
}

Get a Track


Get a Track

Parameters

  • id string Required
  • market string

    The market (an ISO 3166-1 alpha-2 country code)

get - /tracks/{id}
200 - OK
{
  "album": {
    "album_type": "string",
    "available_markets": [
      {},
      {},
      {}
    ],
    "external_urls": {},
    "href": "string",
    "id": "string",
    "images": [
      {
        "height": 123,
        "url": "string",
        "width": 123
      },
      {
        "height": 123,
        "url": "string",
        "width": 123
      },
      {
        "height": 123,
        "url": "string",
        "width": 123
      }
    ],
    "name": "string",
    "type": "string",
    "uri": "string"
  },
  "artists": [
    {
      "external_urls": {},
      "href": "string",
      "id": "string",
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "href": "string",
      "id": "string",
      "name": "string",
      "type": "string",
      "uri": "string"
    },
    {
      "external_urls": {},
      "href": "string",
      "id": "string",
      "name": "string",
      "type": "string",
      "uri": "string"
    }
  ],
  "available_markets": [
    {},
    {},
    {}
  ],
  "disc_number": 123,
  "duration_ms": 123,
  "explicit": true,
  "external_ids": {},
  "external_urls": {},
  "href": "string",
  "id": "string",
  "is_playable": true,
  "linked_from": {
    "external_urls": {},
    "href": "string",
    "id": "string",
    "type": "string",
    "uri": "string"
  },
  "name": "string",
  "preview_url": "string",
  "track_number": 123,
  "type": "string",
  "uri": "string"
}

users


Get a User's Profile


Get a User's Profile

Parameters

  • user_id string Required

    The user's Spotify user ID.

get - /users/{user_id}
200 - OK
{
  "displayName": "string",
  "external_urls": {},
  "followers": {
    "href": "string",
    "total": 123
  },
  "href": "string",
  "id": "string",
  "type": "string",
  "uri": "string"
}

Get a List of a User's Playlists


Get a List of a User's Playlists

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • Accept string

    It is used to set specified media type.

get - /users/{user_id}/playlists
200 - OK
{
  "href": "string",
  "items": [
    {
      "collaborative": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "owner": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "public": true,
      "snapshot_id": "string",
      "tracks": {
        "href": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    },
    {
      "collaborative": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "owner": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "public": true,
      "snapshot_id": "string",
      "tracks": {
        "href": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    },
    {
      "collaborative": true,
      "external_urls": {},
      "href": "string",
      "id": "string",
      "images": [
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        },
        {
          "height": 123,
          "url": "string",
          "width": 123
        }
      ],
      "name": "string",
      "owner": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "public": true,
      "snapshot_id": "string",
      "tracks": {
        "href": "string",
        "total": 123
      },
      "type": "string",
      "uri": "string"
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Create a Playlist


Create a Playlist

Parameters

  • name string Required
  • public boolean
post - /users/{user_id}/playlists
201 - Created
{
  "collaborative": true,
  "description": "string",
  "external_urls": {},
  "followers": {
    "href": "string",
    "total": 123
  },
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    }
  ],
  "name": "string",
  "owner": {
    "displayName": "string",
    "external_urls": {},
    "followers": {
      "href": "string",
      "total": 123
    },
    "href": "string",
    "id": "string",
    "type": "string",
    "uri": "string"
  },
  "public": true,
  "snapshot_id": "string",
  "tracks": {
    "href": "string",
    "items": [
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      },
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      },
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  },
  "type": "string",
  "uri": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a Playlist


Get a Playlist

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • playlist_id string Required

    The Spotify playlist ID.

  • fields string

    A comma-separated list of fields to filter query

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

  • Accept string

    It is used to set specified media type.

get - /users/{user_id}/playlists/{playlist_id}
200 - OK
{
  "collaborative": true,
  "description": "string",
  "external_urls": {},
  "followers": {
    "href": "string",
    "total": 123
  },
  "href": "string",
  "id": "string",
  "images": [
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    },
    {
      "height": 123,
      "url": "string",
      "width": 123
    }
  ],
  "name": "string",
  "owner": {
    "displayName": "string",
    "external_urls": {},
    "followers": {
      "href": "string",
      "total": 123
    },
    "href": "string",
    "id": "string",
    "type": "string",
    "uri": "string"
  },
  "public": true,
  "snapshot_id": "string",
  "tracks": {
    "href": "string",
    "items": [
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      },
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      },
      {
        "added_at": "string",
        "added_by": {
          "displayName": "string",
          "external_urls": {},
          "followers": {
            "href": "string",
            "total": 123
          },
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "is_local": true,
        "track": {
          "album": {
            "album_type": "string",
            "available_markets": [
              {},
              {},
              {}
            ],
            "external_urls": {},
            "href": "string",
            "id": "string",
            "images": [
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              },
              {
                "height": 123,
                "url": "string",
                "width": 123
              }
            ],
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          "artists": [
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            },
            {
              "external_urls": {},
              "href": "string",
              "id": "string",
              "name": "string",
              "type": "string",
              "uri": "string"
            }
          ],
          "available_markets": [
            {},
            {},
            {}
          ],
          "disc_number": 123,
          "duration_ms": 123,
          "explicit": true,
          "external_ids": {},
          "external_urls": {},
          "href": "string",
          "id": "string",
          "is_playable": true,
          "linked_from": {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "type": "string",
            "uri": "string"
          },
          "name": "string",
          "preview_url": "string",
          "track_number": 123,
          "type": "string",
          "uri": "string"
        }
      }
    ],
    "limit": 123,
    "next": "string",
    "offset": 123,
    "previous": "string",
    "total": 123
  },
  "type": "string",
  "uri": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Change a Playlist's Details


Change a Playlist's Details

Parameters

  • name string
  • public boolean
put - /users/{user_id}/playlists/{playlist_id}
200 - OK
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Unfollow a Playlist


Unfollow a Playlist

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • playlist_id string Required

    The Spotify playlist ID.

delete - /users/{user_id}/playlists/{playlist_id}/followers
200 - OK

Follow a Playlist


Follow a Playlist

Parameters

  • public boolean
put - /users/{user_id}/playlists/{playlist_id}/followers
200 - OK

Check if Users Follow a Playlist


Check if Users Follow a Playlist

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • playlist_id string Required

    The Spotify playlist ID.

  • ids string Required

    A comma-separated list of users ids

get - /users/{user_id}/playlists/{playlist_id}/followers/contains
200 - OK
{}

Remove Tracks from a Playlist


Remove Tracks from a Playlist

Parameters

  • tracks array
delete - /users/{user_id}/playlists/{playlist_id}/tracks
200 - OK
{
  "snapshot_id": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Get a Playlist's Tracks


Get a Playlist's Tracks

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • playlist_id string Required

    The Spotify playlist ID.

  • limit integer

    The maximum number of items to return

  • offset integer

    The index of the first item to return

  • fields string

    A comma-separated list of fields to filter query

  • market string

    The market (an ISO 3166-1 alpha-2 country code)

  • Accept string

    It is used to set specified media type.

get - /users/{user_id}/playlists/{playlist_id}/tracks
200 - OK
{
  "href": "string",
  "items": [
    {
      "added_at": "string",
      "added_by": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "is_local": true,
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    },
    {
      "added_at": "string",
      "added_by": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "is_local": true,
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    },
    {
      "added_at": "string",
      "added_by": {
        "displayName": "string",
        "external_urls": {},
        "followers": {
          "href": "string",
          "total": 123
        },
        "href": "string",
        "id": "string",
        "type": "string",
        "uri": "string"
      },
      "is_local": true,
      "track": {
        "album": {
          "album_type": "string",
          "available_markets": [
            {},
            {},
            {}
          ],
          "external_urls": {},
          "href": "string",
          "id": "string",
          "images": [
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            },
            {
              "height": 123,
              "url": "string",
              "width": 123
            }
          ],
          "name": "string",
          "type": "string",
          "uri": "string"
        },
        "artists": [
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          },
          {
            "external_urls": {},
            "href": "string",
            "id": "string",
            "name": "string",
            "type": "string",
            "uri": "string"
          }
        ],
        "available_markets": [
          {},
          {},
          {}
        ],
        "disc_number": 123,
        "duration_ms": 123,
        "explicit": true,
        "external_ids": {},
        "external_urls": {},
        "href": "string",
        "id": "string",
        "is_playable": true,
        "linked_from": {
          "external_urls": {},
          "href": "string",
          "id": "string",
          "type": "string",
          "uri": "string"
        },
        "name": "string",
        "preview_url": "string",
        "track_number": 123,
        "type": "string",
        "uri": "string"
      }
    }
  ],
  "limit": 123,
  "next": "string",
  "offset": 123,
  "previous": "string",
  "total": 123
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Add Tracks to a Playlist


Add Tracks to a Playlist

Parameters

  • user_id string Required

    The user's Spotify user ID.

  • playlist_id string Required

    The Spotify playlist ID.

  • uris string Required

    A comma-separated list of Spotify track URIs to add. A maximum of 100 tracks can be added in one request.

  • position integer

    The position to insert the tracks, a zero-based index

  • Accept string

    It is used to set specified media type.

post - /users/{user_id}/playlists/{playlist_id}/tracks
200 - OK
{
  "snapshot_id": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.

Reorder or replace a Playlist's Tracks


Reorder or replace a Playlist's Tracks

Parameters

  • uris array
put - /users/{user_id}/playlists/{playlist_id}/tracks
200 - OK
{
  "snapshot_id": "string"
}
429 - API rate limit exceeded. See http://developer.spotify.com/web-api/user-guide/#rate-limiting for details.