Search tracks by ISRC

[Henrique Testa]

Hello,

Is there a way to search tracks by ISRC code?

Thanks

[aguywithanidea]

Henrique  ~ not yet, but this functionality will be introduced in v2.2 of the API (which will be introduced very soon!)

We will post in this forum when v2.2 is live.

Thanks for your patience :)

Richard

[Henrique Testa]

Thanks for answer, Richard.

I noticed that v2.2 was released some days ago. Was this functionality included in that version? I couldn't find any docs about how to search by specific fields (other than name).

Thanks again

[aguywithanidea]

Henrique,

You will find the documentation for ISRC search under Get Track by ISRC.

Let us know if we can provide any further assistance,

Richard

[Henrique Testa]

Thanks Richard,

It is exactly what I was looking for.

Also, any plans to support search Album by UPC? :)

[bozena...@miquido.com]

Hello,

I have a question about this endpoint with "catalog" attribute. Seems it doesn't work as expected. In documentation for api v2.2 I can see information: "Unless otherwise specified, all metadata requests will be routed to the US catalog. If you'd like to use a specific catalog other than US, just pass in the two-letter country code (which is case-sensitive)

/v2.2/artists/art.978/bio?limit=5&catalog=DE

/v2.2/artists/art.978/bio?limit=5&catalog=US

Authenticated requests (e.g., those made with OAuth access tokens) will be routed automatically to the member's default catalog.

Napster uses ISO 3166-1 alpha-2 country codes to identify different countries' catalogs."  But I can send there anything and response is still full. For example I have track: "What a wonderful world" id: tra.262370664 - which in case of web playlist it's unavailable: https://app.napster.com/playlists/playlist/mp.244731517 (after login into napster app I have in console requests with catalog GB) - but when I try to get tracks available only in my country by request: http://api.napster.com//v2.2/tracks/isrc/USMC16758823?catalog=GB&apikey=my_api_key - this track is still visible in response. Track endpoint doesn't return information about available for countries for that object so I can't even check this on my side. How can I get proper data? 

Thanks

[aguywithanidea]

Henrique,

We do not currently have this in our backlog of work, but I'll add it so the team can discuss.  I'll let you know what's decided.

Richard

[aguywithanidea]

Hi ~

In this particular the case, the track "tra.262370664" is not available for streaming in your country.  The webclient will not display tracks that the user is unable to play - but the API will return the full metadata for the track regardless of it being playable or not.

To know whether or not the track is playable, look for the key "isStreamable".  If the value is true, then the track is playable.  If it is false, then it is not.

See the highlighted text in red below:  

{"meta": {"totalCount": null,"returnedCount": 1},"tracks": [{"type": "track","id": "tra.262370664","index": 7,"disc": 1,"href": "https://api.napster.com/v2.2/tracks/tra.262370664","playbackSeconds": 0,"isExplicit": false,"isStreamable": false,"name": "What A Wonderful World","isrc": "USMC16758823","shortcut": "various-artists/jazz-universal/what-a-wonderful-world","blurbs": [],"artistId": "art.62012","artistName": "Louis Armstrong","albumName": "Jazz","formats": [{"type": "format","bitrate": 64,"name": "AAC PLUS"}],"albumId": "alb.262370621","contributors": {"primaryArtist": "art.62012"},"links": {"artists": {"ids": ["art.62012"],"href": "https://api.napster.com/v2.2/artists/art.62012"},"albums": {"ids": ["alb.262370621"],"href": "https://api.napster.com/v2.2/albums/alb.262370621"},"genres": {"ids": ["g.299"],"href": "https://api.napster.com/v2.2/genres/g.299"},"tags": {"ids": ["tag.152196537"],"href": "https://api.napster.com/v2.2/tags/tag.152196537"}},"previewURL": "http://listen.vo.llnwd.net/g3/4/8/2/2/3/1338932284.mp3"}]}

[bozena...@miquido.com]

Hi, 

Thank You for the quick response. So there is no option to send country as catalogue parameter? As I understand - this information "isStreamable" come from user access token? 

[aguywithanidea]

Bozena,

Yes, this endpoint does support passing country as the catalog parameter.  But being able to play the track will be entirely based upon the user's access token and whether or not the track is "streamable" in their country.

Also keep in mind that labels routinely modify streaming rights for tracks that in the process in being "re-released" on new issues or compilations - so it's entirely possible to find that a track is periodically not streamable in any country.

Hope this helps,

Richard