---
title: "Retrieve Spotify public profile playlists"
method: GET
path: "/spotify/profile/playlists"
tags: ["Spotify"]
---

# Retrieve Spotify public profile playlists

`GET /spotify/profile/playlists`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/spotify/profile/playlists`
- Auth: API key in header `x-api-key`

Returns public Spotify playlists. Provide username, uri, or url; defaults to Spotify's official profile.

## Query parameters

- `username` string
- `uri` string
- `url` string
- `offset` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyUserProfilePlaylistsResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyUserProfilePlaylistsResponse
    - `limit` integer: Maximum number of playlists requested.
    - `meta` SpotifyUserProfileMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `artistCount` integer: Number of recently played artists returned.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
      - `playlistCount` integer: Number of playlists returned.
      - `profileCount` integer: Number of user profiles returned.
    - `offset` integer: Position of the first playlist returned.
    - `publicPlaylists` SpotifyUserProfilePlaylist[]: Public playlists of the user.
      - `externalUrl` string: Link to the playlist on open.spotify.com.
      - `followersCount` integer: Number of followers the playlist has.
      - `id` string: Spotify ID of the playlist.
      - `imageUrl` string: URL of the playlist cover image.
      - `isFollowing` boolean: Whether Spotify marks the playlist as followed.
      - `name` string: Playlist title as Spotify shows it.
      - `ownerName` string: Display name of the playlist owner.
      - `ownerUri` string: Spotify URI of the playlist owner.
      - `ownerUrl` string: Link to the playlist owner's profile on open.spotify.com.
      - `ownerUsername` string: Spotify username of the playlist owner.
      - `uri` string: Spotify URI of the playlist.
    - `totalPublicPlaylistsCount` integer: Total number of public playlists the user has.
    - `uri` string: Spotify URI of the user.
    - `username` string: Spotify username of the user.
  - `msg` unknown

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `503`: Spotify upstream request failed

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)