Bulk API

From wiki.taptica.com
(Difference between revisions)
Jump to: navigation, search
(Request)
(Response)
Line 85: Line 85:
 
{| border="1" cellspacing="0" cellpadding="2" valign="top"
 
{| border="1" cellspacing="0" cellpadding="2" valign="top"
  
|'''Parameter'''
+
|'''Parameter'''   
|'''Name In Request'''   
+
 
|'''Description'''   
 
|'''Description'''   
 
|'''Example'''   
 
|'''Example'''   
|'''RMandatory''' 
+
 
 
|-
 
|-
  
|Token
+
|ID
|token
+
|Taptica internal offer ID
|Your Taptica private token
+
|Underworld Empire- US- iPhone
|Token=hSuz7l0OUjwVy4uGX2bfAw%3d%3d&platforms
+
|-
|Yes
+
 
 +
|Offer Name
 +
|Taptica internal offer name
 +
|Underworld Empire- US- iPhone
 +
|-
 +
 
 +
|Description
 +
|Offer description
 +
|Play with MILLIONs of players NOW in the LARGEST, most INTENSE, SOCIAL CRIME MMO!
 +
|-
 +
 
 +
|Platform
 +
|Supported platform
 +
|iPhone
 +
|-
 +
 
 +
|Platform
 +
|Minimum OS version
 +
|iPhone
 
|-
 
|-

Revision as of 19:47, 15 August 2013

Taptica Bulk API allows you to get all the offers Meta data from your account. The offers you will get in the results will be attached from the offers that your account manager add to your offers list.

Important!

Since there are frequent changes in the production offer lists The publisher responsible to generate the request every hours. In case offer that was returned in previews response is no longer in the response it's mean you have to Remove the offer from production.


Request

• The request is sent via an HTTP POST to the following URL: http://webapi.reports.taptica.com/v2/bulk?

• The body of the POST contains URL encoded key/value pairs separated by "&".

Example: Post to http://webapi.reports.taptica.com/v2/bulk? token=hSuz7l0OUjwVy4uGX2bfAw%3d%3d&platforms=iPhone&countries=IL,US&payoutType=&minPayout=0&categories=&format=csv

Request parameters

Parameter Name In Request Description Example RMandatory
Token token Your Taptica private token Token=hSuz7l0OUjwVy4uGX2bfAw%3d%3d&platforms Yes
Platforms platforms indicate the Platform of the requested offers. Can be either iPhone, iPad, iPod, Android. platforms=iPhone Yes
Countries countries Enter the country codes of the request offers.can be multiple selection.Note some time you won't get response since Taptica don’t have offer for the specified country. countries=US,UK Yes
PayoutType payoutType specified the requested offer payout. Can be either CPI, CPC, CPM, Mostly Taptica support CPI offers payoutType=cpi Yes
MinPayout minPayout specified the minimume Payout offer you would like to get in the response minPayout=1.2 No
Categories categories specified the offers Categories you would like to get in the response minPayout=Games,Travel%20and%20Local, No
Format format specified the response type can be either JSON,XML,CSV minPayout=Games,Travel%20and%20Local, Yes

Response

Request parameters

Parameter Description Example
ID Taptica internal offer ID Underworld Empire- US- iPhone
Offer Name Taptica internal offer name Underworld Empire- US- iPhone
Description Offer description Play with MILLIONs of players NOW in the LARGEST, most INTENSE, SOCIAL CRIME MMO!
Platform Supported platform iPhone
Platform Minimum OS version iPhone
Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox