Data Feeds

ampsuite provides a number of XML feeds which can be used to power your own website or feed into other systems, as well as powering its own automated newsletters.

By their very nature all data feeds provided are publicly viewable and do not contain any sensitive data.

Most feeds require a company id (or 'CID') to be passed in to them to signify which account to request the data from. For most default ampsuite set ups the CID will always be 2 - however if you have multiple accounts set up within your system or have moved over from the old LMS system to ampsuite your CID may be different. Contact your ampsuite label representative if you are unsure of your CID and the value 2 does not appear to work.

Click the link below to view an example of an ampsuite powered website using one of our default layouts:

https://www.lapsusmusic.com/

If you wish to purchase one of our premade website templates please speak to your ampsuite label representative.

Available Feeds

Below is a complete list of feeds available to you along with a list of parameters you can pass in to them. All example URLs are for our demo system - you should change the demo URL (https://try.ampsuite.com) to the URL of your own ampsuite system. You will also need to change the CID (&cid=) parameter in the URLs to your own company ID (see note above about finding your CID).

If you wish to include an audio player to preview tracks on your website this must be hosted on the ampsuite server to avoid issues with file reading across domains. Please provide us with your desired player for us to host and we will provide you a URL to it which can be displayed via an Iframe on your site. Depending on your hosting settings you may need to change your firewall settings to allow connections to your ampsuite systems URL.

Releases Feed

A list of all of the releases on your system:

https://try.ampsuite.com/xml/releases?
cid=6 Company ID (usually 2 for new customers unless you are running a label management company with multiple ‘accounts’ or are coming from an existing ampsuite/LMS system)
&s_date=1900-01-01 Start date - return releases with a release date after this, always required so set it to something low like this to return all
&e_date=2999-01-01 End date - same as above, set it high to return everything
&order=release_date Order to return releases in, can be any of the fields in the returned XML
&dir=desc Direction to use with the above either asc or desc
&limit=10 Number of releases to return, use with offset for pagination
&offset=0 The release to start returning from so e.g. for 10 releases per page page 1 this is 0, page 2 this is 10, page 3 this is 20 etc.
&ignore_links=y Normally it only returns releases which have the 'audio links' set up in the system (links to the stores you can purchase on) to ignore this set ignore_links to y
&id= Set this to return a specific release whos ID you have got from a previous XML call
&nid= Set to a specific release to exclude that releases from the XML (useful if you want to do an 'Other releases' in the side bar and exclude the main release on the page)

Example return the latest 10 releases on the system:
https://try.ampsuite.com/xml/releases?cid=6&s_date=1900-00-00&e_date=2999-01-01&order=release_date&dir=desc&limit=10

Example return a single release with ID 1910:
https://try.ampsuite.com/xml/releases?cid=6&id=1910

Labels Feed

A list of all of the labels on your system (for parameter meanings see Releases Feed above):

https://try.ampsuite.com/xml/labels?
cid=6
&offset=0
&limit=10
&order=name
&dir=asc
&id=
&nid=

Example return the first 10 labels in alphabetical order:
https://try.ampsuite.com/xml/labels?cid=6&offset=0&limit=10&order=name&dir=asc

Example return a single label with ID 13:
https://try.ampsuite.com/xml/labels?cid=6&id=13

Artists Feed

A list of all of the artists on your system (for parameter meanings see Releases Feed above):

https://try.ampsuite.com/xml/artists?
cid=6
&offset=0
&limit=10
&order=name
&dir=asc
&id=
&nid=
&has_releases=Y Only return artists who have active releases on the system &abc= Only return artists beginning with this letter (special case &abc=0 [number 0] returns all artists beginning with a number or symbol) &full=Y Return extra information including social links, biography and photo

Example return the first 10 artists in alphabetical order:
https://try.ampsuite.com/xml/artists?cid=6&offset=0&limit=10&order=name&dir=asc

Example return a single artist with ID 1 including all social links etc.:
https://try.ampsuite.com/xml/artists?cid=6&id=1&full=Y

RSS News Feed

Date ordered list of stories from your RSS Feed (for parameter meanings see Releases Feed above):

https://try.ampsuite.com/xml/news?
cid=6
&limit=10

Example return latest 10 items from the RSS feed:
https://try.ampsuite.com/xml/news?cid=6&limit=10

News Stories

Used in the newsletter on the system but can be used for content management of website front page stories etc. (for parameter meanings see Releases Feed above):

See the News Stories section of the help guide for details on creating and editing stories. https://try.ampsuite.com/xml/stories?
cid=6
&offset=0
&limit=10
&id=
&nid=

Example return latest 10 news stories:
https://try.ampsuite.com/xml/stories?cid=6&offset=0&limit=10

Mailing List Subscribe

Add an email address to a mailing list.
NB: this service does not return an XML response but just OK if the email was added or INVALID EMAIL if there was a problem. If the email was already on the list it will still return OK.

https://try.ampsuite.com/xml/add_to_mailing_list?
cid=6
&email= The email address to add to the list
&list= The ID of the mailing list to add them to

Example add the email neil@ampsuite.com to the mailing list with ID 1:
https://try.ampsuite.com/xml/add_to_mailing_list?cid=6&email=neil@ampsuite.com&list=1

Mailing List Unsubscribe

Remove an email address from a mailing list.
NB: this service does not return an XML response but just OK regardless of if the email was on the list or not.

https://try.ampsuite.com/xml/add_to_mailing_list?
cid=6
&email= The email address to add to the list(s)

Example remove the email neil@ampsuite.com from all mailing lists:
https://try.ampsuite.com/xml/remove_from_mailing_list?cid=6&email=neil@ampsuite.com