Articles in this section

[API] Let your users import any tracklist to Soundiiz

Thomas
  • Updated
Follow

If your website, app, or service already provides tracklists, Soundiiz can help you turn them into transferable playlists.

This feature is useful for music-related services, playlist curators, wedding playlist builders, DJ tools, event platforms, radio shows, music blogs, record stores, labels, or any business that displays or generates track lists.

By sending a simple JSON tracklist to Soundiiz, you receive a temporary import link. You can then display this link on your website or app, allowing your users to open the tracklist in Soundiiz, review the songs, and transfer them to their preferred music service.

For example, if your service generates a wedding playlist, a DJ setlist, a radio chart, or a curated music selection, you can add a “Transfer with Soundiiz” or “Import to my music service” button next to it.

How it works

Your system sends a POST request to Soundiiz with the playlist title, optional source information, and the list of tracks.

Soundiiz returns a temporary shareUrl.

You can then redirect the user to this URL, open it in a new tab, or attach it to a button on your website.

The user will be able to:

  • review the imported tracklist;
  • search within the list;
  • select or unselect tracks;
  • Continue the transfer to a supported music platform.

Common use cases

This feature can be used by many types of services, including:

  • websites generating wedding playlists;
  • DJ tools and setlist managers;
  • music recommendation apps;
  • radio stations and music charts;
  • music blogs and editorial playlists;
  • record labels and artist websites;
  • event platforms;
  • internal catalog or music management tools.

You do not need to build integrations with every music streaming service yourself. Soundiiz handles the music platform connection and transfer flow.

Endpoint

POST https://soundiiz.com/go/import-playlist
Content-Type: application/json

JSON payload

The request body must be a valid JSON object.

{
  "title": "Wedding Party Playlist",
  "sourceName": "My Wedding Playlist Builder",
  "sourceLogo": "https://example.com/logo.png",
  "description": "A playlist generated for Sarah & James wedding party.",
  "tracklist": [
    {
      "title": "Get Lucky",
      "artists": ["Daft Punk", "Pharrell Williams"]
    },
    {
      "title": "One More Time",
      "artists": ["Daft Punk"]
    },
    {
      "title": "September",
      "artists": ["Earth, Wind & Fire"]
    }
  ]
}

Required fields

title is required and must contain the playlist name.

tracklist is required and must contain between 1 and 200 tracks.

Each track must include a title.

Optional fields

sourceName can be used to display the name of your website, app, service, or tool.

sourceLogo can be used to display your logo on the Soundiiz import page.

description can be used to add extra information about the playlist.

artists can be provided either as an array of artist names or as a single string.

Example with multiple artists:

{
  "title": "Get Lucky",
  "artists": ["Daft Punk", "Pharrell Williams"]
}

Example with one artist as a string:

{
  "title": "Billie Jean",
  "artists": "Michael Jackson"
}

Successful response

If the import is accepted, Soundiiz returns a temporary URL that can be shared with the user.

{
  "status": "success",
  "nbTracks": 3,
  "shareUrl": "https://soundiiz.com/go/import-playlist/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expiresAt": 1782220923
}

shareUrl is the URL to open or display to the user.

nbTracks is the number of tracks accepted by Soundiiz.

expiresAt is a Unix timestamp indicating when the temporary import link expires (24 hours).

Example button flow

A common implementation is:

  1. Your user views a tracklist on your website.
  2. They click a button such as “Transfer with Soundiiz”.
  3. Your backend sends the tracklist to Soundiiz using the POST endpoint.
  4. Soundiiz returns a shareUrl.
  5. Your website redirects the user to this URL.

Example button labels:

Transfer with Soundiiz
Import to my music service
Open in Soundiiz
Save this playlist to Spotify, Apple Music, YouTube Music, and more

cURL example

curl -X POST "https://soundiiz.com/go/import-playlist" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Wedding Party Playlist",
    "sourceName": "My Wedding Playlist Builder",
    "sourceLogo": "https://example.com/logo.png",
    "description": "A playlist generated for Sarah & James wedding party.",
    "tracklist": [
      {
        "title": "Get Lucky",
        "artists": ["Daft Punk", "Pharrell Williams"]
      },
      {
        "title": "One More Time",
        "artists": ["Daft Punk"]
      },
      {
        "title": "September",
        "artists": ["Earth, Wind & Fire"]
      }
    ]
  }'

Error responses

If the request is invalid, Soundiiz returns an error response.

{
  "status": "error",
  "message": "Invalid JSON body."
}

Other possible validation errors include:

{
  "status": "error",
  "message": "Missing playlist 'title' field."
}
{
  "status": "error",
  "message": "Missing or empty 'tracklist'."
}
{
  "status": "error",
  "message": "Missing track title at index 1."
}
{
  "status": "error",
  "message": "Invalid tracklist. Your tracklist must include at least 1 track and up to 200 tracks."
}

Important notes

The import link is temporary and should be used shortly after being generated.

The tracklist must contain at least 1 track and up to 200 tracks.

Soundiiz uses the provided track titles and artists to help users match and transfer the songs to their selected destination platform.

This endpoint does not directly create a playlist in a user account. It creates a temporary Soundiiz import page where the user can review the tracklist and choose where to transfer it.

Related articles