Feeds Introduction
Here you will find detailed documentation on our catalog feeds. Every Friday morning, we will add several hundred new ringtones, graphics, and games. Since the files below are large and dynamic, we recommend using Wget with a weekly cron job to import the freshest content.
Locations
| Feed URL | Description |
|---|---|
| http://thumbplay.com/catalog/AllContent.xml | Content for all categories. |
| http://thumbplay.com/catalog/Ringtones.xml | All realtones and polytones. |
| http://thumbplay.com/catalog/Realtones.xml | Realtones only. |
| http://thumbplay.com/catalog/Polytones.xml | Polytones only. |
| http://thumbplay.com/catalog/Graphics.xml | Graphics only. |
| http://thumbplay.com/catalog/Games.xml | Games only. |
XML DTD
<?xml version="1.0" encoding="UTF-8"?>
<!ELEMENT catalog ((provider, publishDate, name, contactName, contactEmail, content+))>
<!ELEMENT provider (#PCDATA)>
<!ELEMENT publishDate (#PCDATA)>
<!ELEMENT name (#PCDATA)>
<!ELEMENT contactName (#PCDATA)>
<!ELEMENT contactEmail (#PCDATA)>
<!ELEMENT content ((contentId, createDate, lastUpdateDate, contentType, title, description, artist?, albumName?, category?, imageSmallURL, imageMediumURL, imageLargeURL, previewURL, mobilePurchaseURL, webPurchaseURL, artistLandingPageURL, titleLandingPageURL))>
<!ELEMENT contentId (#PCDATA)>
<!ELEMENT createDate (#PCDATA)>
<!ELEMENT lastUpdateDate (#PCDATA)>
<!ELEMENT contentType ((id, name))>
<!ELEMENT id (#PCDATA)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT description (#PCDATA)>
<!ELEMENT artist ((id, name, url))>
<!ELEMENT url (#PCDATA)>
<!ELEMENT albumName (#PCDATA)>
<!ELEMENT category ((id, name, url, category?))>
<!ELEMENT imageSmallURL (#PCDATA)>
<!ELEMENT imageMediumURL (#PCDATA)>
<!ELEMENT imageLargeURL (#PCDATA)>
<!ELEMENT previewURL (#PCDATA)>
<!ELEMENT mobilePurchaseURL (#PCDATA)>
<!ELEMENT webPurchaseURL (#PCDATA)>
<!ELEMENT artistLandingPageURL (#PCDATA)>
<!ELEMENT titleLandingPageURL (#PCDATA)>
Sample XML
<content>
<contentId>471267</contentId>
<createDate>Tue, 5 Sep 2006 14:31:27 CDT</createDate>
<lastUpdateDate>Wed, 31 Dec 1969 18:00:00 CST</lastUpdateDate>
<contentType>
<id>6</id>
<name>Music ringtone</name>
</contentType>
<title>There's A Tear In My Beer</title>
<description/>
<artist>
<id>9300</id>
<name>Hank Williams Jr.</name>
<url><![CDATA[http://ringtones.thumbplay.com/Hank+Williams+Jr.-ringtones?pname=[pname]]]></url>
</artist>
<albumName>Greatest Hits Vol. 3 (Curb)</albumName>
<category>
<id>398</id>
<name>Country</name>
<url><![CDATA[http://ringtones.thumbplay.com/Country-genre-ringtones?pname=[pname]]]></url>
<category>
<id>836</id>
<name>Classic Country</name>
<url><![CDATA[http://ringtones.thumbplay.com/Country-genre-Classic+Country-subgenre-ringtones?pname=[pname]]]></url>
</category>
</category>
<imageSmallURL><![CDATA[http://images.m-kube.com/muzecovers/75/156735.jpg]]></imageSmallURL>
<imageMediumURL><![CDATA[http://images.m-kube.com/muzecovers/170/156735.jpg]]></imageMediumURL>
<previewURL><![CDATA[http://preview.thumbplay.com/VAN/Thumb_Preview/Real/UMG/Hank_Williams.Theres_A_Tear_In_My_Beer-00602498852033-30.mp3]]></previewURL>
<mobilePurchaseURL><![CDATA[http://m.thumbplay.com/tp/infomo?view=details2&pname=[pname]&cid=471267]]></mobilePurchaseURL>
<webPurchaseURL><![CDATA[http://www.thumbplay.com/join/Hank+Williams,+Jr.-artist-There's+A+Tear+In+My+Beer-realtones-bonus?pname=[pname]]]></webPurchaseURL>
<artistLandingPageURL><![CDATA[http://offers.thumbplay.com/offers/[pname]/artisttitle?thpartist=Hank+Williams%2C+Jr.]]></artistLandingPageURL>
<titleLandingPageURL><![CDATA[http://offers.thumbplay.com/offers/[pname]/artisttitle?thptitle=There%27s+A+Tear+In+My+Beer&thpartist=Hank+Williams%2C+Jr.]]></titleLandingPageURL>
</content>
Required Tracking Parameters
The following three elements reference Thumbplay’s landing pages. These URLs include a [pname] token that requires a valid ID so that partners receive credit for all activity.
- artistLandingPageURL
- titleLandingPageURL
- mobilePurchaseURL
Example token replacement using the artistLandingPageURL:
<artistLandingPageURL><![CDATA[http://offers.thumbplay.com/offers/[pname]/artisttitle?thpartist=Kanye+West]]></artistLandingPageURL>
Partner with the pname “1003” would replace the [pname] token with “1003” and send traffic to the following URL:
http://offers.thumbplay.com/offers/1003/artisttitle?thpartist=Kanye+West
Optional Tracking Parameters
Partners may wish to track placements by appending a thpcampid value to the landing page URL. The thpcampid supports up to 50 characters (no spaces or symbols; underscores and dashes are fine).
Example landing page URL with thpcampid value appended:
http://offers.thumbplay.com/offers/1003/artisttitle?thpartist=Kanye+West&thpcampid=example-tracking-ID
Landing Pages
- When the artist and title are known values, partners should direct traffic the the titleLandingPageURL
- When the artist is the only known value, partners should direct traffic to the artistLandingPageURL
- When the integration is on a mobile site, partners should direct traffic to the mobilePurchaseURL
- Please note: be sure not to direct traffic to the webPurchaseURL