Feeds

Here you will find detailed documentation on our catalog feeds. Every Friday morning, we add several hundred new ringtones, graphics, games and videos. Since the files below are large and dynamic, we recommend using Wget with a weekly cron job to import the freshest content.

1. 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/Videos.xml	Videos only.
http://thumbplay.com/catalog/Games.xml	Games only.

2. 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)>

3. 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>

4. 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

5. 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

6. Landing Pages

In order to optimize user experience and conversion rates, we recommend the following:

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

Jobs