| 7digital API site and version |
| artist/search | API endpoint name - search artists |
| ?shopId=2020 | Parameter to identify UMG catalog |
| \&oauth\_consumer\_key=7d4vr6cgb392 | Parameter for consumer key |
| \&q=john | Parameter for search query string |
## API Endpoint List
The following table lists the endpoints that we have made available for this hackathon. For each endpoint there is a sample call that works and returns real results. Click on these links to see how each call is constructed and obtain the call responses
| Endpoint | Use | Sample Call | Main Parameter |
| ---------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Artist browse | Browse the catalog for artist names that start with supplied text string | [GET artist/browse](http://api.7digital.com/1.2/artist/browse?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&letter=ki) | letter={text} |
| Artist search | Search the catalog for artists that match a supplied text string | [GET artist/search](http://api.7digital.com/1.2/artist/search?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&q=john) | q={text} |
| Artist releases | Returns a list of streamable releases for a specific artist | [GET artist/releases](http://api.7digital.com/1.2/artist/releases?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&artistId=1448\&usageTypes=adsupportedstreaming) | \&artistId={int}
\&usageTypes=adsupportedstreaming
|
| Artist toptracks | Returns a list of streamable tracks for a specific artist | [GET artist/toptracks](http://api.7digital.com/1.2/artist/toptracks?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&artistId=1448\&usageTypes=adsupportedstreaming) | \&artistId={int}
\&usageTypes=adsupportedstreaming
|
| Release search | Search the catalog for releases
that match a supplied text string
| [GET release/search](http://api.7digital.com/1.2/release/search?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&q=john\&usageTypes=adsupportedstreaming) | \&q={text}
\&usageTypes=adsupportedstreaming
|
| Release tracks | Returns a list of streamable tracks for a specific release | [GET release/tracks](http://api.7digital.com/1.2/release/tracks?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&releaseId=5726299\&usageTypes=adsupportedstreaming) | \&releaseId={int}
\&usageTypes=adsupportedstreaming
|
| Track search | Search the catalog for releases that match a supplied text string | [GET track/search](http://api.7digital.com/1.2/track/search?shopId=2020\&oauth_consumer_key=7d4vr6cgb392\&q=john\&usageTypes=adsupportedstreaming) | \&q={text}
\&usageTypes=adsupportedstreaming
|
| Track stream | Stream full length (or partial clip) audio for a specific track | **See later page** | \&trackId={int} |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://cloudinary.gitbook.io/cil-hackathon-guide/capitol360-december-2018-hacktathon-guide/7digital/using-7digital-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.