# Spotify Playlist API (https://www.socialcrawl.dev/platforms/spotify/playlist) > Returns a public Spotify playlist by id or link: its name, the owner as Spotify labels it (`post.author.display_name`, for example Spotify on an editorial playlist) and its tracks in playlist order in `post.ext.tracks`, each with its id, title, artists as a list, length in seconds, explicit flag and link. A long playlist returns its first 100 tracks. The playlist's cover, follower count and total length are not included. When the first source cannot answer, a further source serves the playlist with its first 50 tracks. TL;DR: `GET /v1/spotify/playlist` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `id` | no | Spotify playlist id, the 22 characters after /playlist/ in a link, for example 37i9dQZEVXbMDoHDwVN2tF. | | `url` | no | A Spotify playlist link instead of id. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/spotify/playlist" \ --data-urlencode "url=https://open.spotify.com/playlist/37i9dQZEVXbMDoHDwVN2tF" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### What does the Spotify Playlist API return? Returns one public Spotify playlist: its name, the owner as Spotify labels it, and its tracks in order with each track's artists as a list. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields. ### When should I use the Spotify Playlist endpoint? Use it to read what a playlist holds, such as a chart or an editorial list; track gives one song in full. ### How much does the Spotify Playlist API cost? Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription. ### What parameters does the Spotify Playlist API need? Identify the target with one of id, url. It also accepts 2 optional parameters, all listed on this page. ### How do I call the Spotify Playlist API? Send a GET request to https://www.socialcrawl.dev/v1/spotify/playlist?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2F37i9dQZEVXbMDoHDwVN2tF with your API key in the x-api-key header. An Authorization: Bearer header works too. See the full Spotify API: https://www.socialcrawl.dev/platforms/spotify ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - What does the SocialCrawl Spotify Playlist API return? - How do I get Spotify Playlist data with the SocialCrawl API?