Motive Feed Integration Documentation (Version 1)

This version is deprecated, please upgrade to version 3. We will not be supporting this version anymore.


Obtaining your API Key and Affiliate ID

  1. Go to: http://affiliates.motiveinteractive.com/
  2. Click on the "Reporting API" button near the top.
  3. Copy the information highlighted in red, you need to use that to build your request URL.

Request interval:

Our feed updates once every hour, so our recommendation is to have a max interval pull of once per hour and a minimum of at least once a day too ensure the data is synchronized between your application and our server.


URL: http://motivefeed.com/affiliate/1/campaigns?api_key=[API_KEY]&affiliate_id=[AFFILIATE_ID]


Parameter Summary:

api_key / STRING = Affiliate API Key

affiliate_id / INT = Affiliate ID


Sample GET Call:

XML: http://motivefeed.com/affiliate/campaigns?api_key=[API_KEY]&affiliate_id=[AFFILIATE_ID]

JSON: http://motivefeed.com/affiliate/campaigns.json?api_key=[API_KEY]&affiliate_id=[AFFILIATE_ID]


Response Type:

success - STRING: Request success status

totals_rows - INT: Total number of rows


campaigns > campaign:

campaign_id - INT: Campaign ID

offer_id - INT: Offer ID

tracking_link - STRING: Tracking link URL

payout - STRING: Payout amount in string format with $ in front of the number

> allowed_media_types > media_type > item:

type_id - INT: Media type ID

type_name - STRING: Media type name

category_id - INT: Media category ID

type_name - STRING: Media category name

> allowed_countries:

allowed_country - STRING: Two letter country code in uppercase

> allowed_devices:

allowed_device - STRING: Allowed device name in lowercase

> app_details:

app_id - STRING: Apple App Store/Google Play Store App ID

app_icon_small - STRING: Small icon image link

app_icon_large - STRING: Large icon image link

developer - STRING: App developer name/company

rating - FLOAT: App rating in decimal, rating is on a scale from 0 - 5

content - STRING: App description

number_of_reviews - INT: Number of reviews

file_size - STRING: File size in MB

downloads - STRING: Number of downloads (Only available for Google Play Store apps)


Sample XML Response:
                

        <?xml version="1.0" encoding="UTF-8"?>
        <xml>
        <success>true</success>
        <total_rows>14</total_rows>
        <campaigns>
          <campaign>
             <campaign_id>166104</campaign_id>
             <offer_id>55191</offer_id>
             <offer_name>Game of Thrones (dc)</offer_name>
             <tracking_link>https://traktum.com/?a=64578&c=226217&s1=</tracking_link>
             <payout>$2.00</payout>
             <allowed_media_types>
                <media_type>
                   <item>
                      <type_id>7</type_id>
                      <type_name>Banner</type_name>
                      <category_id>1</category_id>
                      <category_name>Display</category_name>
                   </item>
                   <item>
                      <type_id>16</type_id>
                      <type_name>Social Media</type_name>
                      <category_id>4</category_id>
                      <category_name>Other</category_name>
                   </item>
                </media_type>
             </allowed_media_types>
             <allowed_countries>
                <allowed_country>DK</allowed_country>
                <allowed_country>FI</allowed_country>
                <allowed_country>DE</allowed_country>
                <allowed_country>NL</allowed_country>
                <allowed_country>AU</allowed_country>
                <allowed_country>AN</allowed_country>
                <allowed_country>BE</allowed_country>
                <allowed_country>NZ</allowed_country>
                <allowed_country>CA</allowed_country>
                <allowed_country>NO</allowed_country>
                <allowed_country>SI</allowed_country>
                <allowed_country>SE</allowed_country>
                <allowed_country>GB</allowed_country>
                <allowed_country>US</allowed_country>
             </allowed_countries>
          </campaign>
          <campaign>
             <campaign_id>133075</campaign_id>
             <offer_id>54282</offer_id>
             <offer_name>Book of Heroes iOS (dc) (c)</offer_name>
             <tracking_link>https://traktum.com/?a=64578&c=177879&s1=</tracking_link>
             <payout>$1.40</payout>
             <allowed_media_types />
             <app_details>
                <app_id>455999097</app_id>
                <app_icon_small>http://a1077.phobos.apple.com/us/r30/Purple/v4/3a/f2/2b/3af22b09-4d02-906d-dfc1-a9af51ba1037/icon.png</app_icon_small>
                <app_icon_large>http://a871.phobos.apple.com/us/r30/Purple6/v4/be/ad/8f/bead8f5a-5b0e-c16e-b0a9-7d66266ab0fc/mzl.ravkrptq.png</app_icon_large>
                <developer>Venan Entertainment, Inc.</developer>
                <rating>4.5</rating>
                <title>Book Of Heroes</title>
                <content>The time for your ultimate adventure has come! Create your hero today and jump right into the action!  <br />
        <br />
        - Fight against terrifying monsters where you choose and trigger your abilities in our unique time-based battle system!<br />
        <br />
        - Customize your character with thousands of options and become a Shadow Walker, War Mage or Justicar!<br />
        <br />
        - Explore dangerous dungeons, complete over 300 quests and gather loot!<br />
        <br />
        - Enjoy a massively multiplayer experience with real time chat, guilds and raids!<br />
        <br />
        - Upgrade your player with powerful skills and abilities and customize with special equipment!<br />
        <br />
        - Save your home from the evil forces of darkness!<br />
        <br />
        Book of Heroes is constantly being updated with new features, group raids, and cool content! Give it a try, it's FREE!<br />
        <br />
        Visit our Facebook page at http://facebook.com/bookofheroes for news and promotions, and to Like us :)<br />
        <br />
        This game requires an internet connection.</content>
                <number_of_reviews>5155</number_of_reviews>
                <filesize>43.59M</filesize>
             </app_details>
             <allowed_countries>
                <allowed_country>AU</allowed_country>
                <allowed_country>CA</allowed_country>
                <allowed_country>GB</allowed_country>
                <allowed_country>US</allowed_country>
             </allowed_countries>
          </campaign>
          <campaign>
             <campaign_id>168754</campaign_id>
             <offer_id>55854</offer_id>
             <offer_name>Dragon City (iOS) (c) - US iPad</offer_name>
             <tracking_link>https://traktum.com/?a=64578&c=257007&s1=</tracking_link>
             <payout>$2.80</payout>
             <allowed_media_types>
                <media_type>
                   <type_id>7</type_id>
                   <type_name>Banner</type_name>
                   <category_id>1</category_id>
                   <category_name>Display</category_name>
                </media_type>
             </allowed_media_types>
             <app_details>
                <app_id>561941526</app_id>
                <app_icon_small>
                    http://a755.phobos.apple.com/us/r30/Purple4/v4/cd/99/37/cd9937af-1383-a5ff-cb0d-33ec60848017/Icon.png
                </app_icon_small>
                <app_icon_large>
                    http://a878.phobos.apple.com/us/r30/Purple4/v4/e2/d4/d0/e2d4d003-fe53-51a9-ff2e-062ec0492ec6/mzl.lwowjsdz.png
                </app_icon_large>
                <developer>Social Point</developer>
                <rating>4.5</rating>
                <title>Dragon City Mobile</title>
                <content>Build and decorate a magical, floating Dragon City! Breed dragons and hatch eggs to discover new species!<br />
        <br />
        Feed, grow and train your dragons for combat.  Customize your dragon team and engage in combat with opponents from all over the world! <br />
        <br />
        Prove yourself as a true Dragon Master! <br />
        <br />
        Dragon City is completely connected to the Facebook version, which means you can take care of your dragons, enter in to battle and manage your DragonCity anytime, anywhere!<br />
        <br />
        FEATURES:<br />
        <br />
        • 100+ different dragons so far... with new dragons landing on Dragon City every week! <br />
        • Build your Dragon City with lots of farms, special buildings and gorgeous decorations! <br />
        • Battle online with thousands of players and their dragon teams! <br />
        • Breed and combine up to 10 types of Dragons: Terra, Flame, Sea, Nature, Electric, Ice, Metal, Dark, Legend and Pure! <br />
        • 160+ goals to complete! <br />
        • Experience the cutest animated graphics ever! <br />
        • Invite and help your Facebook friends by sending gifts! Sharing is caring!</content>
                <number_of_reviews>103181</number_of_reviews>
                <filesize>49.74M</filesize>
             </app_details>
             <allowed_devices>
                <allowed_device>ipad</allowed_device>
                <allowed_device>iphone</allowed_device>
             </allowed_devices>
             <allowed_countries>
                <allowed_country>US</allowed_country>
             </allowed_countries>
          </campaign>
          <campaign>
             <campaign_id>171217</campaign_id>
             <offer_id>55231</offer_id>
             <offer_name>Dragons of Atlantis: Heir of the Dragon iOS (dc) - iPhone _CA,  CH, NO, SE, DK  [default]</offer_name>
             <tracking_link>https://traktum.com/?a=64578&c=228824&s1=</tracking_link>
             <payout>$3.00</payout>
             <allowed_media_types>
                <media_type>
                   <type_id>7</type_id>
                   <type_name>Banner</type_name>
                   <category_id>1</category_id>
                   <category_name>Display</category_name>
                </media_type>
             </allowed_media_types>
             <app_details>
                <app_id>558756671</app_id>
                <app_icon_small>
                    http://a1398.phobos.apple.com/us/r30/Purple/v4/65/f8/92/65f89219-e09b-ce96-325a-23e86d2c32cc/Icon.png
                </app_icon_small>
                <app_icon_large>
                    http://a1481.phobos.apple.com/us/r30/Purple/v4/8a/67/8b/8a678b50-eec6-2679-7ba2-f78f46046088/mzl.rrqmhkvi.png
                </app_icon_large>
                <developer>Kabam Inc.</developer>
                <rating>4.5</rating>
                <title>Dragons of Atlantis: Heirs of the Dragon</title>
                <content>***The Web Hit with Over 15 Million Players All Time is now available on iOS!*** <br />
        <br />
        Join thousands of players as you rebuild lost glories in Dragons of Atlantis: Heirs of the Dragon! (Dragons web players: This game does not connect to your web kingdom - it's an all-new mobile game.) <br />
        <br />
        The Ancients fled Atlantis in the wake of a cataclysm. The savage Anthropus overran the Lost Continent. The Dragons are dying. It's up to you to rebuild ruined cities, rediscover ancient wisdom, and save the Dragons of Atlantis! <br />
        <br />
        REBUILD THE GLORY OF ATLANTIS <br />
        Recover the lost wisdom of the Ancients <br />
        <br />
        FIND DRAGON EGGS! <br />
        Raise mighty, fully interactive, 3D Dragons <br />
        <br />
        CUSTOMIZE YOUR DRAGONS <br />
        For battle with powerful Dragon Armor <br />
        <br />
        FOLLOW THE CAMPAIGN STORYLINE <br />
        Reclaim Atlantis from the savage Anthropus <br />
        <br />
        FORGE ALLIANCES WITH OTHER PLAYERS <br />
        Plan strategy in real time with live chat <br />
        <br />
        ALLIANCE COMMUNITY FEATURES <br />
        Get matched with Alliances which match your play style! <br />
        <br />
        RETINA DISPLAY GRAPHICS! <br />
        For a hi-def gaming experience <br />
        <br />
        <br />
        **************Important************** <br />
        <br />
        Note: A network connection is required to play <br />
        Works with iPhone 3GS, 4, 4S, 5, iPod touch 3rd, 4th & 5th gen, and iPad. <br />
        <br />
        Requires iOS 4.3 or later. <br />
        <br />
        **************************************  <br />
        By downloading this game, you agree to the Terms of Service, Privacy Policy and License Agreement.  <br />
        <br />
        https://www.kabam.com/corporate/terms-of-service  <br />
        https://www.kabam.com/corporate/privacy-policy<br />
        http://corporate.kabam.com/media/2013/07/31/kabam-inc-eula-en/</content>
                <number_of_reviews>2436</number_of_reviews>
                <filesize>50.12M</filesize>
             </app_details>
             <allowed_devices>
                <allowed_device>iphone</allowed_device>
             </allowed_devices>
             <allowed_countries>
                <allowed_country>CA</allowed_country>
                <allowed_country>DK</allowed_country>
                <allowed_country>NO</allowed_country>
                <allowed_country>SE</allowed_country>
                <allowed_country>CH</allowed_country>
             </allowed_countries>
          </campaign>
          <campaign>
             <campaign_id>164046</campaign_id>
             <offer_id>54897</offer_id>
             <offer_name>Jackpot Bingo - Android (dc) - JackpotBingo_Android_Tier1_CPI</offer_name>
             <tracking_link>https://traktum.com/?a=64578&c=211085&s1=</tracking_link>
             <payout>$0.75</payout>
             <allowed_media_types>
                <media_type>
                   <item>
                      <type_id>7</type_id>
                      <type_name>Banner</type_name>
                      <category_id>1</category_id>
                      <category_name>Display</category_name>
                   </item>
                   <item>
                      <type_id>27</type_id>
                      <type_name>Text Links</type_name>
                      <category_id>4</category_id>
                      <category_name>Other</category_name>
                   </item>
                </media_type>
             </allowed_media_types>
             <app_details>
                <app_id>jp.gree.jband</app_id>
                <app_icon_small>
                    https://lh4.ggpht.com/StcI891DWraYiRZnQDcff6B5ylWBt0InbpNpo6HtW8waWpiFZ0joNDXzaOqxe0bppQw=w300
                </app_icon_small>
                <app_icon_large>
                    https://lh4.ggpht.com/StcI891DWraYiRZnQDcff6B5ylWBt0InbpNpo6HtW8waWpiFZ0joNDXzaOqxe0bppQw=w300
                </app_icon_large>
                <developer>GREE, INC</developer>
                <rating>4.5</rating>
                <title>Jackpot Bingo -Free Bingo Game</title>
                <content>***Limited time offer: download now to get FREE prizes!***<p><br>Experience Bingo like never before! With rewarding charms, valuables to collect, and captivating themes, Jackpot Bingo is non-stop fun.</p>
        <p><br>Whether you play bingo at home or on the go, Jackpot Bingo gives you brand new ways to enjoy the classic game. Compete in a variety of destination themed rooms, play multiple cards, use customizable charms, earn collectibles, master different ways to win, and much more! </p>
        <p><br>Jackpots await you in this addictive free-to-play bingo game, complete with:</p>
        <p><br>• Exciting and mysterious locations that will enhance your bingo experience like never before with high quality art and gameplay<br>• Unique free special rooms. Play in bingo game shows and speed rooms to see how you stack up.<br>• Boosts and charms that earn you valuable rewards<br>• Play bingo to unlock new exclusive styles and patterns<br>• Hit the jackpot with multiple cards<br>• Earn, trade, and redeem premium collections<br>• Nonstop casino fun with classic cards and original themes<br>• Ongoing content and feature updates!<br>* Tons of free chips and coins to play all day!</p>
        <p><br>Our players agree:<br><br>&#9733;&#9733;&#9733;&#9733;&#9733;<br>Love it. Best Bingo game I have played so far.<br>- Lenia<br><br>&#9733;&#9733;&#9733;&#9733;&#9733;<br>Wonderful, easy to play.<br>- Minnie<br><br>&#9733;&#9733;&#9733;&#9733;&#9733;<br>Love this game. Awesome new addiction!<br>- Nicole</p>
        <p>Like us on Facebook and keep up to date with the latest on the game!<br><a href="https://www.google.com/url?q=https://www.facebook.com/JackpotBingoGame&sa=D&usg=AFQjCNEODgKxcv3qWOCLAIeotR510CBXuQ" target="_blank">https://www.facebook.com/JackpotBingoGame</a></p></content>
                <number_of_reviews>25309</number_of_reviews>
                <downloads>1,000,000 - 5,000,000</downloads>
                <filesize>Varies with device</filesize>
             </app_details>
             <allowed_devices>
                <allowed_device>android</allowed_device>
             </allowed_devices>
             <allowed_countries>
                <allowed_country>CA</allowed_country>
                <allowed_country>NO</allowed_country>
                <allowed_country>SG</allowed_country>
                <allowed_country>US</allowed_country>
             </allowed_countries>
          </campaign>
        </campaigns>
        </xml>                    
                

© Motive Feed