Please Sign in
The 7digital API (beta) gives access to 7digital services and music data allowing developers to create new music download and streaming applications using web services.
API users will be given a unique API key that is used to access the API methods and can also be used to track any commissions due from sales that derive from API usage.
Access to the API for non-commercial use is free. If you wish to use the API in a commercial application, please contact us outlining the proposed usage and we'll get back to you. Commercial users can also access additional API methods allowing creation of more sophisticated commercial music services.
Access to the services provided by 7digital is provided through a REST interface.
The production API is located at the following address:
http://api.7digital.com/1.2/For development and testing please use the test API located here:
http://api.7digital.com/sandbox/1.2/A typical API request will look as follows:
http://api.7digital.com/1.2/artist/details?artistId=1&oauth_consumer_key=yourkey
Access to the 7digital API is controlled by a consumer key which needs to passed in parameter oauth_consumer_key with every request. API keys are issued upon request. To obtain one, please apply at www.7digital.com/api.
Premium API methods require requests to be signed using OAuth authentication protocol for more details please see the 7digital Premium API documentation.
Standard responses will be returned in XML format.
A successful response will have the following format:
<response status="ok" version="1.2"> <response_content /> </response>
A response status of error means an error has occurred whilst processing a request. A failed request will instead of the results content contain an error message element:
<response status="error" version="1.2"> <error code="1001"> <errorMessage>Missing artist ID</errorMessage> </error> </response>
Erorr codes can be split into following categories:
1XXX - invalid or missing input parameters
1001 - Required parameter missing
1002 - Invalid parameter value
1003 - Parameter value out of allowable range
1006 - Invalid enumeration value
2XXX - Invalid resource reference
2001 - Resource cannot be found
2002 - Resource is not available in current context
2003 - Resource already exists
7XXX - 7digital API application error
7001 - Unable to perform action
7002 - Application configuration error
7003 - Operation timed out
9xxx - Internal server error
9001 - Unexpected internal server error
Should you receive an error with error code 7000 and above please contact us with the details of the request that caused it and as much additional details as possible that might help us to reproduce it. Our API team will investigate the cause and respond to you promptly.
Should your API request fail authentication a response with HTTP Status Code 401 will be returned along with plain text message describing the reason of the authentication failure.
Please ensure you're using a valid api key and accessing the correct API endpoint.
Requests to some special methods will return a client redirect (e.g. basket/checkout) or serve a media file (e.g. track/streampreview) instead of an XML response.
7digital download stores are available in several countries across the world. In order to be able to provide users with the maximum possible amount of content available in their country and display prices in their local currency whenever possible, all API methods accept a special parameter country. This parameter expects a 2 letter ISO country code (eg. GB, US, DE). If a country code is not supplied, all operations will be actioned on the default store - currently the UK one.
Commercial customers who have a dedicated shop with custom content set up should instead of country code use parameter shopId set to the id assigned to them. Please contact our business department to enquire about this option.
All API methods that return a list of items in the response accept the following paging parameters:
| name | type | use | description |
|---|---|---|---|
page | int | optional | Page number of the result set. If not supplied, defaults to 1 |
pageSize | int | optional | Number of items to be returned per page. If not supplied, defaults to 10. Maximum page size is 500 |
Paging information will also be included in the response as per the format bellow:
<page>1</page> <itemsPerPage>10</itemsPerPage> <totalItems>21</totalItems>
Most of the API responses will consist of one or a list of standard objects as described below. The level of available detail in the response may vary depending on the method. In the examples below, all possible fields are included.
<artist id="14"> <name>The Charlatans</name> <sortName>Charlatans, The</sortName> <appearsAs>The Charlatans</appearsAs> <image>http://cdn.7static.com/static/img/artistimages/00/000/000/0000000014_50.jpg</image> <url>http://www.7digital.com/artists/the-charlatans/?partner=123</url> </artist>Description of response fields:
| name | type | description |
|---|---|---|
artist@id | integer | unique identifier of artist in 7digital catalogue |
name | string | name of the artist |
appearsAs | string | name of the artist as it appears on the track or release (this field is only available when artist object is returned attached to a track or release) |
sortName | string | name of the artist as used for sorting |
image | URL | url of a picture of the artist |
url | URL | link to shop where artist's releases & tracks can be purchased |
Albums, singles and videos are all considered and referred to as releases.
Example response:<release id="155408"> <title>Dreams</title> <version>UK</version> <type>Album</type> <barcode>00602517512078</barcode> <year>2007</year> <explicitContent>false</explicitContent> <artist id="29755"> <name>The Whitest Boy Alive</name> <appearsAs>The Whitest Boy Alive</appearsAs> <url>http://www.7digital.com/artists/the-whitest-boy-alive/?partner=123</url> </artist> <image>http://cdn.7static.com/static/img/sleeveart/00/001/554/0000155408_50.jpg</image> <url>http://www.7digital.com/artists/the-whitest-boy-alive/dreams-(1)/?partner=123</url> <releaseDate>2007-10-22T00:00:00+01:00</releaseDate> <addedDate>2007-10-11T12:18:29+01:00</addedDate> <price> <currency code="GBP">£</currency> <value>5</value> <formattedPrice>£5.00</formattedPrice> <rrp>1.79</rrp> <formattedRrp>£7.79</formattedRrp> <isOnSale>true</isOnSale> </price> <formats availableDrmFree="True"> <format id="17"> <fileFormat>MP3</fileFormat> <bitRate>320</bitRate> <drmFree>True</drmFree> </format> <format id="1"> <fileFormat>WMA</fileFormat> <bitRate>192</bitRate> <drmFree>False</drmFree> </format> </formats> <label id="40"> <name>Universal-Island Records Ltd.</name> </label> </release>Description of response fields:
| name | type | description |
|---|---|---|
release@id | integer | unique identifier of the release in 7digital catalogue |
title | string | title of the release |
version | string | version title of the release |
type | enumaration | type of the release, one of: album, single, video |
barcode | string | barcode of the product (typically UPC) |
year | integer | year of the original release (as supplied to 7digital by the issuing label, where data is not available, year of the digital release) |
explicitContent | boolean | parental advisory - explicit content tag, as supplied to 7digital by the issuing label |
artist | artist object | primary artist of the release (subset of fields of the full artist details as described above) |
image | URL | url of the release cover picture |
url | URL | link to 7digital page where this release can be purchased |
releaseDate | datetime | date and time the release is available to download from |
addedDate | datetime | date and time the release has been added to 7digital catalogue |
price | price object | pricing information |
formats | list of format objects | list of formats the tracks appearing on this release are available in |
label | label object | contains 7digital id and name of the issuing label |
Each release contains 1 or more tracks. As the same track can appear on multiple releases to uniquely identify a track from a particular release you need to use both trackId and releaseId.
Example response:<track id="1628015"> <title>Burning</title> <version /> <artist id="29755"> <name>The Whitest Boy Alive</name> <appearsAs>The Whitest Boy Alive</appearsAs> <url>http://www.7digital.com/artists/the-whitest-boy-alive/</url> </artist> <trackNumber>1</trackNumber> <duration>189</duration> <explicitContent>false</explicitContent> <isrc>DED620600065</isrc> <release id="155408"> <title>Dreams</title> <version>UK</version> <type>Album</type> <artist id="29755"> <name>The Whitest Boy Alive</name> <appearsAs>The Whitest Boy Alive</appearsAs> <url>http://www.7digital.com/artists/the-whitest-boy-alive/?partner=123</url> </artist> <url>http://www.7digital.com/artists/the-whitest-boy-alive/dreams-1/?partner=123</url> <image>http://cdn.7static.com/static/img/sleeveart/00/001/554/0000155408_50.jpg</image> </release> <url>http://www.7digital.com/artists/the-whitest-boy-alive/dreams-1/01-Burning/?partner=123</url> <price> <currency code="GBP">£</currency> <value>0.79</value> <formattedPrice>£0.79</formattedPrice> <rrp>0.79</rrp> <formattedRrp>£0.79</formattedRrp> <onSale>false</onSale> </price> </track>Description of response fields:
| name | type | description |
|---|---|---|
track@id | integer | unique identifier of the track in 7digital catalogue |
title | string | title of the track |
version | string | version of the track (e.g. "Radio Edit") |
artist | artist object | the primary artist of the track |
order | integer | position the track appears on the release |
duration | integer | the length of the track in seconds |
explicitContent | boolean | parental advisory - explicit content tag, as supplied to 7digital by the issuing label |
isrc | string | ISRC code |
release | release object | release the track appears on |
url | URL | link to 7digital page where this release can be purchased |
price | price object | pricing information |
Both releases and tracks have prices. In some cases, the value is not specified and the formatted price shows "N/A". In this case, either the release is not purchasable (tracks have to be bought individually) or, conversely, if a track price doesn't have a value, the track is not available separately (the whole release has to be purchased).
Example response:<price> <currency code="GBP">£</currency> <value>1.79</value> <formattedPrice>£1.79</formattedPrice> <rrp>1.99</rrp> <formattedRrp>£1.99</formattedRrp> <onSale>true</onSale> </price>Description of response fields:
| name | type | description |
|---|---|---|
currency | string | currency symbol |
currency@code | string | code of the currency (ISO 4217) |
value | decimal | numerical value of the price |
formattedPrice | string | price pre-formatted to currencie's local format for easier displaying |
rrp | decimal | numerical value of recommended retail price |
formattedRrp | string | pre-formatted RRP |
onSale | boolean | specifies whether the item is currently on sale |
Format describes in what file format a track(s) is(are) available for download.
Example response:<format id="17"> <fileFormat>MP3</fileFormat> <bitRate>320</bitRate> <drmFree>True</drmFree> </format>Description of response fields:
| name | type | description |
|---|---|---|
format@id | integer | 7digital unique identifier of the format |
fileFormat | string | type of the media file format |
bitRate | integer | bitrate of the media file in kbit/s |
drmFree | boolean | specifies whether the format includes DRM protection |
returns all available artist details
Method specific parameters:| name | type | use | description |
|---|---|---|---|
artistId | integer | required | unique identifier of the artist |
http://api.7digital.com/1.2/artist/details?artistid=1&oauth_consumer_key=demo&country=GBExample response:
<response status="ok" version="1.2"> <artist id="1"> <name>Keane</name> <sortName>Keane</sortName> <url>http://www.7digital.com/artists/keane/</url> <image>http://cdn.7static.com/static/img/artistimages/00/000/000/0000000001_150.jpg</image> </artist> </response>
returns list of artists from the 7digital catalogue matching the start letter (or multiple letters)
Method specific parameters:| name | type | use | description |
|---|---|---|---|
letter | string | required | the first letter(s) of the artists to browse |
http://api.7digital.com/1.2/artist/browse?letter=p&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2">
<artists>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>3256</totalItems>
<artist id="144641">
<name>P J Harvey</name>
<url>http://www.7digital.com/artists/p-j-harvey/?partner=123</url>
<sortName>P J Harvey</sortName>
<image>http://cdn.7static.com/static/img/artistimages/00/001/446/0000144641_50.jpg</image>
</artist>
<artist id="17168">
<name>P J Proby</name>
...
</artist>
...
</artists>
</response>
Returns list of artist search matches from the 7digital catalogue.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
q | string | required | search query |
http://api.7digital.com/1.2/artist/search?q=pink&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2"> <searchResults> <page>1</page> <pageSize>10</pageSize> <totalItems>24</totalItems> <searchResult> <type>artist</type> <artist id="226"> <name>Pink</name> <url>http://www.7digital.com/artists/pink/?partner=123</url> <sortName>Pink</sortName> <image>http://cdn.7static.com/static/img/artistimages/00/000/002/0000000226_50.jpg</image> </artist> </searchResult> <searchResult> ... </searchResults> </response>
returns a list of releases by given artist. Releases can be filtered by type.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
artistId | integer | required | unique identifier of the artist |
type | album, single, video | optional | if specified results are filtered by given release type |
http://api.7digital.com/1.2/artist/releases?artistid=1&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2"> <releases> <page>1</page> <pageSize>10</pageSize> <totalItems>42</totalItems> <release id="172744"> <title>Live-Trailer</title> <version /> <type>Video</type> ... </release> <release id="36567"> ... </release> </releases> </response>
Returns a list of most popular tracks by artist.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
artistId | integer | required | unique identifier of the artist |
http://api.7digital.com/1.2/artist/toptracks?artistid=1&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2"> <tracks> <page>1</page> <pageSize>10</pageSize> <totalItems>13</totalItems> <track id="1628043"> <title>The Night Sky</title> <version /> ... </track> </tracks> </response>
Returns a chart of the most popular artists for given period.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
period | day, week, month | optional | period the chart is generated for, default value is week |
toDate | YYYYMMDD | optional | last day the chart includes data for, default value is yesterday's date |
http://api.7digital.com/1.2/artist/chart?period=week&toDate=20090601&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2"> <chart> <type>artist</type> <fromDate>2009-03-24T00:00:00Z</fromDate> <toDate>2009-03-30T00:00:00+01:00</toDate> <page>1</page> <pageSize>10</pageSize> <totalItems>20</totalItems> <chartItem> <position>1</position> <change>Up</change> <artist id="162872"> <name>The Last Shadow Puppets</name> <url>http://www.7digital.com/artists/the-last-shadow-puppets/?partner=123</url> </artist> </chartItem> <chartItem> <position>2</position> <change>Down</change> ... </chartItem> </chart> </response>
Returns all available details for a release
Method specific parameters:| name | type | use | description |
|---|---|---|---|
releaseId | integer | required | Id of the release |
http://api.7digital.com/1.2/release/details?releaseid=155408&oauth_consumer_key=YOUR_KEY_HEREExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<release id="155408">
<title>Dreams</title>
<version>UK</version>
<type>Album</type>
<barcode>00602517512078</barcode>
<year>2007</year>
<explicitContent>false</explicitContent>
<artist id="29755">
<name>The Whitest Boy Alive</name>
<appearsAs>The Whitest Boy Alive</appearsAs>
<url>http://www.7digital.com/artists/the-whitest-boy-alive/</url>
</artist>
<url>http://www.7digital.com/artists/the-whitest-boy-alive/dreams-1/</url>
<image>http://cdn.7static.com/static/img/sleeveart/00/001/554/0000155408_50.jpg</image>
<releaseDate>2007-10-22T00:00:00+01:00</releaseDate>
<addedDate>2007-10-11T12:18:29+01:00</addedDate>
<price>
<currency code="GBP">£</currency>
<value>7.99</value>
<formattedPrice>£7.99</formattedPrice>
<rrp>7.99</rrp>
<formattedRrp>£7.99</formattedRrp>
<onSale>false</onSale>
</price>
<formats availableDrmFree="true">
<format id="17">
<fileFormat>MP3</fileFormat>
<bitRate>320</bitRate>
<drmFree>true</drmFree>
</format>
</formats>
<label id="40">
<name>Universal-Island Records Ltd.</name>
</label>
</release>
</response>
Returns release(s) by a specified date range
Method specific parameters:| name | type | use | description |
|---|---|---|---|
fromDate | date - format is YYYYMMDD | required | The first day to include data for. |
toDate | date - format is YYYYMMDD | required | The last day to include data for. |
http://api.7digital.com/1.2/release/bydate?fromDate=20090610&toDate=20090603&oauth_consumer_key=YOUR_KEY_HEREExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" > <releases> <page>1</page> <pageSize>10</pageSize> <totalItems>10</totalItems> <release id="445267"> <title>Devils Claws E.P</title> <version></version> <type>Album</type> <barcode>5055285610081</barcode> <year>2009</year> ... <label id="21856"> <name>Brother Convention Records</name> </label> </release> </releases> </response>
Returns list of recommended releases for given release or artist.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
releaseId / artistId | integer | required | Id of the release or artist the recommendations are being displayed for. Exatly one of the ids (either releaseId or artistsId) has to be specified |
page | integer | optional | Page number of the required result set. default value is 1. |
pageSize | integer | optional | Number of items to be returned per page. default value is 50. |
http://api.7digital.com/1.2/release/recommend?releaseid=155408&oauth_consumer_key=YOUR_KEY_HERE&country=GBExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<recommendations>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>10</totalItems>
<recommendedItem>
<release id="34281">
<title>Sudden Rush</title>
<version></version>
<type>Single</type>
<barcode>0724355187055</barcode>
...
</release>
</recommendedItem>
</recommendations>
</response>
Search 7digital catalogue for releases matching the search query. Results can be filtered by release type.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
q | string | required | Search Query |
type | enumeration - album, single, video | optional | If specified results are filtered by given release type (multiple types separated by commas can be passed). |
page | integer | optional | Page number of the required result set. default value is 1. |
pageSize | integer | optional | Number of items to be returned per page. default value is 50. |
http://api.7digital.com/1.2/release/search?q=no%20surprises&oauth_consumer_key=YOUR_KEY_HERE&country=GBExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<searchResults>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>4393</totalItems>
<searchResult>
<type>release</type>
<release id="145882">
<title>No Surprises</title>
<version></version>
<type>Video</type>
<barcode>0094637383858</barcode>
...
</release>
</searchResult>
</searchResults>
</response>
Chart of most-purchased releases for given period. Currently, only albums are included in this chart.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
period | enumeration - day, week, month, year | optional | The period the chart is generated for. Default value is week |
toDate | date - format YYYYDDMM | optional | Last day the chart includes data for. default value is yesterday's date |
page | integer | optional | Page number of the required result set. default value is 1 Number of items to be returned per page. default value is 10 |
pageSize | integer | optional | Number of items to be returned per page. Default value is 10 |
http://api.7digital.com/1.2/release/chart?period=month&todate=20080801&oauth_consumer_key=YOUR_KEY_HERE&country=GBExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<chart>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>20</totalItems>
<type>album</type>
<fromDate>2009-07-01T00:00:00+01:00</fromDate>
<toDate>2009-07-07T00:00:00+01:00</toDate>
<chartItem>
<position>1</position>
<change>New</change>
<release id="484694">
<title>Lungs</title>
<version></version>
<type>Album</type>
<barcode>00602527116761</barcode>
...
</release>
</chartItem>
</chart>
</response>
This method will return various track details such as title and duration.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
trackId | integer | required | The unique identifier of the track. |
http://api.7digital.com/1.2/track/details?trackid=12345&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2">
<track id="12345">
<title>I Love You</title>
<version />
<artist id="437">
<name>The Dandy Warhols</name>
<appearsAs>The Dandy Warhols</appearsAs>
<url>http://www.7digital.com/artists/the-dandy-warhols/?partner=123</url>
</artist>
<trackNumber>5</trackNumber>
<duration>252</duration>
<explicitContent>false</explicitContent>
<isrc>USCA29600191</isrc>
<release id="1302">
<title>...The Dandy Warhols Come Down</title>
<version />
<type>Album</type>
...
</release>
</track>
</response>
This method will search for a track name that matches the supplied search query.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
q | string | required | The search query string. |
http://api.7digital.com/1.2/track/search?q=HappyExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd"> <searchResults> <page>1</page> <pageSize>10</pageSize> <totalItems>4386</totalItems> <searchResult> <type>track</type> <track id="2855447"> <title>Happy</title> <version/> ... </track> </searchResult> </searchResults> </response>
Returns a list of all available tags.
Method specific parameters:None.
Example request:http://api.7digital.com/1.2/tagExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd"> <tags> <page>1</page> <pageSize>10</pageSize> <totalItems>629</totalItems> <tag id="pop"> <text>pop</text> <url>http://www.7digital.com/tags/pop?partner=712</url> <count>90847</count> </tag> <tag id="rock"> <text>rock</text> <url>http://www.7digital.com/tags/rock?partner=712</url> <count>52454</count> </tag> ... </tags> </response>
Returns all tags the artist has been tagged with.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
artistId | integer | required | unique identifier of the artist |
http://api.7digital.com/1.2/artist/tags?artistid=1&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2">
<tags>
<tag id="rock">
<text>rock</text>
<url>http://www.7digital.com/tags/rock?partner=123</url>
</tag>
<tag id="united-kingdom">
<text>united kingdom</text>
<url>http://www.7digital.com/tags/united-kingdom?partner=123</url>
</tag>
...
</tags>
</response>
This method returns all tags the release has been tagged with.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
releaseId | integer | required | The ID of the release. |
http://api.7digital.com/1.2/release/tags?releaseid=155408&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd">
<tags>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>5</totalItems>
<tag id="rock">
<text>rock</text>
<url>http://www.7digital.com/tags/rock</url>
</tag>
<tag id="pop">
<text>pop</text>
<url>http://www.7digital.com/tags/pop</url>
</tag>
<tag id="electronic">
<text>electronic</text>
<url>http://www.7digital.com/tags/electronic</url>
</tag>
<tag id="indie-rock">
<text>indie rock</text>
<url>http://www.7digital.com/tags/indie-rock</url>
</tag>
<tag id="2000s">
<text>2000s</text>
<url>http://www.7digital.com/tags/2000s</url>
</tag>
</tags>
</response>
Returns list of most popular artists tagged by a given tag or list of tags. If multiple tags are supplied only artists matching all of them will be returned.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
tags | string | required | tag or comma separated list of tags |
http://api.7digital.com/1.2/artist/bytag/top?tags=rock,pop,2000s&oauth_consumer_key=your_key&country=GBExample response:
<response status="ok" version="1.2">
<taggedResults>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>24</totalItems>
<taggedItem>
<type>artist</type>
<artist id="226">
<name>Pink</name>
<url>http://www.7digital.com/artists/pink/?partner=123</url>
<sortName>Pink</sortName>
<image>http://cdn.7static.com/static/img/artistimages/00/000/002/0000000226_50.jpg</image>
</artist>
</taggedItem>
<taggedItem>
...
</taggedItem>
</taggedResults>
</response>
Returns list of new releases tagged by a given tag or list of tags. If multiple tags are supplied only releases matching all of them will be returned. The most recent releases are returned first.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
tags | string | required | tag or comma separated list of tags |
page | int | optional | page number of the required result set. default value is 1 |
pageSize | int | optional | umber of items to be returned per page. default value is 10 |
http://api.7digital.com/1.2/release/bytag/new?tags=rock&page=2&pageSize=100&oauth_consumer_key=YOUR_KEY_HEREExample response:
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<taggedResults>
<page>2</page>
<pageSize>100</pageSize>
<totalItems>35451</totalItems>
<type>release</type>
<taggedItem>
<release id="416648">
<title>In Stereo</title>
<version></version>
<type>Album</type>
...
</release>
</taggedItem>
</taggedResults>
</response>
Returns list of most popular releases tagged by a given tag or list of tags. if multiple tags are supplied only releases matching all of them will be returned.
Method specific parameters:| name | type | use | description |
|---|---|---|---|
tags | string | required | tag or comma separated list of tags |
page | int | optional | page number of the required result set. default value is 1 |
pageSize | int | optional | umber of items to be returned per page. default value is 10 |
http://api.7digital.com/1.2/release/bytag/top?tags=rock&page=1&pageSize=10&oauth_consumer_key=YOUR_KEY_HEREExample response:
<?xml version="1.0" encoding="utf-8" ?>
<response status="ok" version="1.2" xsi:noNamespaceSchemaLocation="http://api.7digital.com/1.2/static/7digitalAPI.xsd" >
<taggedResults>
<page>1</page>
<pageSize>10</pageSize>
<totalItems>35451</totalItems>
<type>release</type>
<taggedItem>
<release id="398603">
<title>It's Blitz!</title>
<version></version>
<type>Album</type>
...
</release>
</taggedItem>
</taggedResults>
</response>