https://github.com/paxsenix0/spotify-canvas-api
Unofficial API to fetch Spotify Canvas video data (the looping visual videos that appear behind songs on mobile).
https://github.com/paxsenix0/spotify-canvas-api
api canvas-api nodejs spotify spotify-api spotify-canvas spotify-canvas-api
Last synced: 2 months ago
JSON representation
Unofficial API to fetch Spotify Canvas video data (the looping visual videos that appear behind songs on mobile).
- Host: GitHub
- URL: https://github.com/paxsenix0/spotify-canvas-api
- Owner: Paxsenix0
- License: gpl-3.0
- Created: 2024-02-11T12:37:11.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-09T15:40:08.000Z (3 months ago)
- Last Synced: 2025-05-09T01:49:35.447Z (2 months ago)
- Topics: api, canvas-api, nodejs, spotify, spotify-api, spotify-canvas, spotify-canvas-api
- Language: JavaScript
- Homepage: https://api.paxsenix.biz.id
- Size: 115 KB
- Stars: 16
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Spotify Canvas API
Unofficial API to fetch Spotify **Canvas video data** (the looping visual videos that appear behind songs on mobile).
> [!WARNING]
> This project uses undocumented endpoints and may violate [Spotify's Terms of Service](https://www.spotify.com/legal/end-user-agreement/). Use at your own risk.
---
## Features
- Retrieve **Canvas video URLs** by track ID or URI
- Parses Protobuf responses from the internal Spotify API
- Works with public or private tracks (as long as you're authenticated)
---
## Example Request
### GET `/api/canvas`
```bash
https://localhost:3000/api/canvas?trackId=3OHfY25tqY28d16oZczHc8
```
### Response:
```json
{
"data": {
"canvasesList": [
{
"id": "32b57cbf354b453a95eee32bb04d4e42",
"canvasUrl": "https://canvaz.scdn.co/upload/licensor/5bSw7fRotCnRCcO9br14W5/video/32b57cbf354b453a95eee32bb04d4e42.cnvs.mp4",
"trackUri": "spotify:track:3OHfY25tqY28d16oZczHc8",
"artist": {
"artistUri": "spotify:artist:7tYKF4w9nC0nq9CsPZTHyP",
"artistName": "SZA",
"artistImgUrl": "https://i.scdn.co/image/ab6761610000f1780895066d172e1f51f520bc65"
},
"otherId": "2c441fceb502eaa25f26bcd5b1ccfc0d",
"canvasUri": "spotify:canvas:1xGyujDyxbx4eTPD4nKLw6"
}
]
}
}
```
---
## Setup
### 1. Clone the Repo
```bash
git clone https://github.com/Paxsenix0/Spotify-Canvas-API.git
cd Spotify-Canvas-API
```
### 2. Install Dependencies
```bash
npm install
```
### 3. Set Required Environment Variable
You must supply your sp_dc cookie from a logged-in Spotify session.
Create a .env file in the root:
```bash
SP_DC=your_sp_dc_cookie_here
```
> This cookie is used to generate an access token to authenticate requests.
---
## Deployment
You can deploy instantly with Vercel:
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2FPaxsenix0%2FSpotify-Canvas-API%2Ftree%2Fmain&project-name=Spotify-Canvas-API&repository-name=Spotify-Canvas-API&env=SP_DC&envDescription=SP_DC%20is%20needed%20for%20this%20for%20authentication%20to%20be%20working%20fine&envLink=https%3A%2F%2Fwww.spotify.com%2F&redirect-url=https%3A%2F%2Fgithub.com%2FPaxsenix0%2FSpotify-Canvas-API)
---
## Notes
> I'm developing this project entirely on my phone, without a PC or laptop. Also, I'm still learning — so feel free to send pull requests or suggestions if something looks off!
---
## Reference
Shoutout to this helpful repo that inspired parts of this:
https://github.com/bartleyg/my-spotify-canvas
---
## License
This project is licensed under the MIT license. see [LICENSE](https://github.com/Paxsenix0/Spotify-Canvas-API/blob/initial/LICENSE) for details.
---
## Contact
Telegram: [@paxsenix0](https://t.me/paxsenix0)
Email: [email protected]
My Rest-API website: https://api.paxsenix.biz.id
---