Music Distributor monitoring

[Believe_Crew]

Plan

Music Distributor : Believe

Country

France

My Question or Issue

As a music Distributor, Believe Society, we try to monitor our ingestion process. Therefore we would like to know the status of our release by Spotify system : in progress, in error, insert/update or take down successful.

After our analysis about Spotify API, we have few questions we want to discuss with Spotify.

Could you provide us answers about our conclusion.

Our goals are about monitoring the ingestion process of the tracks by using your APi about our deliveries (either an insert, an update or a takedown)

We use the documentation below :

  https://developer.spotify.com/private-documentation/ 

and the API available here : https://developer.spotify.com/dashboard/ 

We use also the documentation below :

https://developer.spotify.com/documentation/web-api/ 

https://developer.spotify.com/documentation/general/guides/authorization-guide/ 

https://developer.spotify.com/documentation/web-api/reference/tracks/get-track/ 

Our conclusion is the API does not allow to get informations about the ingestion process or also about the publication status of the products.

The API allows to get details informations about the albums, tracks, playlist, User profile once the product are “live”.

Once the products are published on Spotify Store, Spotify generates an ID allows to get complete informations about the track.

Here is an example we manage to use :  https://api.spotify.com/v1/tracks/<spotify ID>

Moreover we try to use the following API :

1. https://analytics.spotify.com/faq/api#how-do-i-get-access-to-spotifys-provider-apis
2. https://api.spotify.com/v1/search

·        The endpoint Search https://api.spotify.com/v1/search?q=upc%3A<UPC ID>&type=album allows to get an album through its UPC.
If the response is empty, then the product does not exist in Spotify store

·        By calling the following APIs https://analytics.spotify.com/faq/api#how-do-i-get-access-to-spotifys-provider-apis we are supposed to be able to have access to informations about product ingestion process and product publishing process

Most of the API needs a Spotify ID to get information about an album or track. However the Spotify ID is created after the products publication, so this won’t be able to give information during the ingestion process. 

However we managed to get information through the following endpoint https://developer.spotify.com/documentation/web-api/reference/search/search/  based on the track UPC, we did not get information based on the Believe’s release ID

If the product doesn’t exist for Spotify, the API give a response with an empty table else the table will contain all the available information about the product.

This allows Believe to know if a product has been correctly ingested by Spotify but this will not give information about the steps of ingestion process.

[Hubo]

Hey @Believe_Crew, thanks for coming to the Community for help!

Awesome to hear you're using the Spotify API in your application. For questions about this private API, I recommend getting in touch with the Analytics API team by emailing this question to them at: analytics-api@spotify.com. Let me know if you have any other questions.

Have a good one,

Hubo

[nmgglobal]

Your approach is correct, you can check by UPC, but for detailed status you can use Scatman (Spotify Catalog Manager) to monitor the ingestion process as described here: Can labels and distributors check the status of content on Spotify?

We are still not familiar with Bulk API for providers, but after you get the Release ID from Scatman you can query it if that's all it requires.