Search and Save Track to Collection
A 4-step recipe with TIDAL. We can help you get access.
Recipe · 4 steps
Search and Save Track to Collection
with TIDAL · Metadata Cataloguing
Find a track by search and save it to the user's collection.
- Read the searchResult for the query including its tracks relationship so a matched track id is available.
- Follow the searchResult tracks relationship to obtain the first matched track identifier.
- Confirm the matched track exists in the catalog before saving it to the user's collection.
- Add the confirmed track to the authenticated user's userCollectionTracks items relationship, using `me` to target the caller's collection.
What you'll need to have ready
- accessToken: OAuth 2.0 bearer access token with collection.write scope.
- query: The free-text search query used as the searchResult resource id.
- countryCode: ISO 3166-1 alpha-2 country code (e.g. US).
For your developer
Arazzo workflow tidal:search-and-save-track, 4 operations: {$sourceDescriptions.searchresultsApi.url}#/paths/~1searchResults~1{id}/get → {$sourceDescriptions.searchresultsApi.url}#/paths/~1searchResults~1{id}~1relationships~1tracks/get → {$sourceDescriptions.tracksApi.url}#/paths/~1tracks~1{id}/get → {$sourceDescriptions.usercollectiontracksApi.url}#/paths/~1userCollectionTracks~1{id}~1relationships~1items/post. Specs on APIs.io.