Search the MassiveMusic catalogue for artists, releases, and tracks by query terms and filters, then use returned IDs in downstream workflows.
Use Search to find artists, releases, and tracks in the MassiveMusic catalogue by search terms and filters.
Search is useful when your service needs catalogue lookup or discovery without storing the full catalogue. Search responses include IDs and metadata that you can use in downstream workflows such as streaming, downloads, playlists, Media Transfer, purchase logging, and reporting.
Choose a search type
Find artists that match a search query, then use returned artist results to support discovery, browsing, or follow-up release and track searches.
Find albums, EPs, singles, and other releases, then use returned releaseId values in download, purchase, playlist, or reporting workflows.
Find individual tracks, then use returned trackId values for streaming, downloads, playlists, Media Transfer, or reporting.
How to use each search
| Search type | Use it when you need to... | Key values returned | What to do next |
|---|---|---|---|
| Artist Search | Find artists by query text. | Artist id, name, popularity, and score. | Show artist results or use the artist result to guide release and track discovery. |
| Release Search | Find releases such as albums, EPs, or singles. | Release id, title, UPC, artist, label, licensor, availableFor, packages, formats, popularity, and score. | Use the release id for purchase logging, release downloads, browsing, playlists, or reporting. |
| Track Search | Find individual tracks. | Track id, release details, artist, ISRC, title, duration, availableFor, packages, formats, popularity, and score. | Use the track id for streaming, download delivery, Media Transfer, playlists, purchase logging, or reporting. |
Common request parameters
All three search endpoints use a query term and your Consumer Key. Release Search and Track Search can also filter results by usage type.
| Parameter | Used by | Description |
|---|---|---|
q | Artist, Release, Track | Search query text. |
oauth_consumer_key | Artist, Release, Track | Your Consumer Key. |
country | Artist, Release, Track | ISO 2-character country code used for catalogue access and availability context. |
pagesize | Artist, Release, Track | Number of results to return per page. |
usageTypes | Release, Track | Comma-separated usage types such as download, subscriptionstreaming, or adsupportedstreaming. |
Example requests
GET https://api.7digital.com/artist/search?q=Test&oauth_consumer_key=YOUR_KEY_HERE&country=GB&pagesize=10GET https://api.7digital.com/release/search?q=Test&oauth_consumer_key=YOUR_KEY_HERE&country=GB&pagesize=10&usageTypes=download,subscriptionstreaming,adsupportedstreamingGET https://api.7digital.com/track/search?q=Test&oauth_consumer_key=YOUR_KEY_HERE&country=GB&pagesize=10&usageTypes=download,subscriptionstreaming,adsupportedstreamingResult ordering
Search responses are weighted by popularity based on platform usage. Each result also includes a score value that represents how closely it matched the query.
Next steps
- Use Artist Search when your user is searching for an artist.
- Use Release Search when your workflow needs a
releaseId, package, price, or format information. - Use Track Search when your workflow needs a
trackId, ISRC, duration, availability, package, or format information.