Introduction Last updated: 28-12-2021

Create personalized assets to share your music with friends on social.

Landscape Card Example

This is how your card will look in landscape orientation:

Open in New Tab

Square Card Example

And here's a square card for ya.

Open in New Tab

Portrait Card Example

This one's portrait.

Open in New Tab

Usage

There are different parameters you can use to customize the card to your preference.

By Song Track Name

Use the name of your song to link it.

Results can differ as there can be another song with the same name.

Use


                    https://spotify-cards.up.railway.app/api?name={song name}

Example


                    https://spotify-cards.up.railway.app/api?name=Silver%20Lining

By Song Track ID

Use the Track ID of your song to link it.

Recommended

How to get Spotify Song Track ID?

Go to your song.
Right click >> Share (Keeping Ctrl pressed) >> Copy Spotify URI
The ID after spotify:track: is the Spotify Song Track ID.

Use


                    https://spotify-cards.up.railway.app/api?id={song id}

Example


                    https://spotify-cards.up.railway.app/api?id=05iALOptaNoV3EmXnxz1IJ

Color

Provide a custom background color to your card.

Use


                    https://spotify-cards.up.railway.app/api?id={song
                    id}&color={color hex without #}

Example


                    https://spotify-cards.up.railway.app/api?id=05iALOptaNoV3EmXnxz1IJ&color=A0C3D2

Default Behaviour

If no color property is mentioned in the request, the best color corresponding to the song image will be used.

Using # in hex code will lead to random behaviour.

Orientation

We support three orientations for the card: Landscape, Square and Portrait.

Use


                    https://spotify-cards.up.railway.app/api?id={song
                    id}&color={color hex without
                    #}&orientation={landscape/square/portrait}

Example


                    https://spotify-cards.up.railway.app/api?id=05iALOptaNoV3EmXnxz1IJ&color=A0C3D2&orientation=square

Default Behaviour

If no orientation property is mentioned in the request, Landscape will be used.

Github

Report a bug, request a feature, or contribute to the API.

Bug

If you come across an unexpected behaviour, please consider reporting it on our Github repository.

Report bugs

Feature

Do you think something is missing in this API? Request a feature on our Github repository.

Request features

Contribute

Want to contribute to this API? Fork our Github repository now, and feel free to create a PR with your awesome changes.

Fork Now