Skip to content

Spotify Bulk API Onboarding

Thank you for your interest in accessing the Bulk API. Spotify’s Bulk API enables recording licensors to obtain comprehensive insights into the daily performance of their catalog. This data encompasses streams, skips, saves, users, and tracks. Additionally, the Bulk API offers an endpoint for direct access to all charts available on charts.spotify.com. If you’re interested in the Spotify Web API, you can find more details about it here.

Onboarding Process

To gain access to the Bulk API, several steps must be completed first. This is a necessary part of the onboarding process and allows us to set up your access quickly.

For organizations new to the Bulk API:

Please complete all steps to prepare for access starting with step 1. Failure to complete these steps will prevent you from completing the application form correctly and delay your request. If your organization is collaborating with third parties (ie delivery platform) who will access Bulk API data on your behalf, you (licensor) must still complete the steps for your organization.

For organizations with existing access to the Bulk API:

An account with access permissions has already been established for your organization. You should not submit another request as you can share your existing account authentication details and private documentation with your team or third parties. If a third party requires access to your data using their Spotify developer account, please submit their account email using your organization’s details when completing the form in Step 6.

Should you require any information during your onboarding process, please contact your commercial partnership manager.

Step 1 - Locate your Spotify Licensor ID

You should already possess a unique Spotify Licensor ID that has been shared with you to deliver your content to Spotify.. This ID is used to identify your organization, enabling us to properly configure your Bulk API data connection. The required ID follows this format:

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

If you're having trouble finding this ID, your commercial partnership manager or delivery platform should be able to help you locate it.

Step 2 - Locate your Spotify For Artists Label Team ID

Your Spotify Label Team, which was established to give you access to Spotify For Artists, has a unique ID. This ID, similar to the licensor ID, helps us identify your organization and correctly set up your user accounts. This ID follows a specific format: 

spotify:label:xxxxxxxxxxxxxxxxxxxxxx

To locate your label team ID, follow these steps:

  1. Visit the Spotify for Artists website and log in using an account associated with the label team created for your organization.

  2. Once logged in, locate your username displayed in the top-right corner of the screen and click on it.

  3. A dropdown menu will appear. Select the option that says “Teams.”

  4. On this page, click on the licensor-level Label Team.

  5. The Label Team ID (22 characters) is located within the URL, specifically the last part of the path.

  6. Make note of and submit this ID or the full URL in Step 6.

If you can't locate your team, your commercial partnership manager can assist you.

Please Note: During the content ingestion process, a team was created for your organization with the name '[Content Provider] Your Organization Name.' We cannot use this team to provide Bulk API access, so a new team may need to be created.

If you're certain your organization doesn't have a licensor-level Spotify For Artists Label Team, please follow the instructions in the 'Labels and Distributors' section to create one.

Step 3 - Setting Up a New Spotify Account

It's recommended that you create a new email alias on behalf of your organization. This should be a team email that's associated with your organizational domain. A suggested format could be "spotify-provider-api@<your_domain>.com".

Please Note: While personal accounts from your organization's domain are permitted, we've found it's generally more practical to establish a team account. This is because a team account allows for the sharing of API credentials and private documentation among several team members. So, if a team member leaves or changes their role, access won't be disrupted and there won't be a need to add new people. This method ensures a seamless and uninterrupted operation.

To set up a new Spotify account using this new email, please follow the steps provided here.

Step 4 - Enabling Your Developer Account

  1. First, visit the Spotify for Developers website and sign into your account.

  2. After you've logged in, look for your username displayed in the top-right corner of the screen and click on it.

  3. A dropdown menu will appear. Select the option that says "Dashboard".

  4. On this page, you'll be presented with the "Spotify Developer Terms".

  5. You'll find a checkbox labeled "I accept...". After carefully reading and understanding these terms, please click on this checkbox to confirm your agreement.

  6. To finalize the process, click on the button that says "Accept the terms".

Please Note: Do not create an application in the dashboard at this step; if you do, it will not work with the Bulk API. Instead, we will set up a dedicated application for you. This custom application will have the necessary permissions for accessing your specific licensor-level data in your own Bulk API.

Step 5 - Accepting the Bulk API Terms of Service

To review the terms and conditions for using the API, please follow this link. 

After reviewing the terms, fill out the form with your organization's details and submit it.

Please Note: While one agreement is enough for your organization, it's essential to remember that these terms and conditions will also apply to any third parties to whom you provide your credentials for API access on your organization's behalf.

After submitting the form, a copy of the contract will be sent to the email address you used during the signing process.

Step 6 - Submit all required information

After completing all the previous steps, please submit all the required information using this form.

If you're having trouble accessing the form or encounter any errors, your commercial partnership manager can assist with the submission.

Next Steps:

Once your information is submitted, we'll start processing your information and setting up our system with the appropriate user permissions. If everything goes smoothly, expect a welcome email from us within 3-5 business days. This email will contain further instructions on how to access the API. Should we need more information, we'll get in touch.