Request API base URL:
API request Parameters:
|tid||Appnext tool - should be always API||&tid=API||Mandatory, do not change this|
|id||Placement ID - a 32-character string|
generated by Appnext for every
registered app/mobile-web app that
is required for all inbound requests
|did||Google Advertising ID (GAID) OR|
A 32-characters string
|cnt||The number of campaigns received|
in the API response
|&cnt=20||&cnt=200 Optional – up to 200 apps per call. if not added to the call, the default will be cnt=1|
|pimp=1||Count an impression whenever|
an campaigns “pixel_imp” link is
|&pimp=1||Once added to the call, a new field will appear - "pixelImp"|
|Optional. Passing a pbk parameter|
will add a value ("q") to all urlApp fields
in the returned campaigns
|lockcat||Getting campaigns under specific|
Google Play categories
|&lockcat=cards||Optional. If you would like to add several categories, please use encode|
|ip||The client Ip address||&ip=192.168.2.6||This is mandatory for server side|
integration. It’s important not to
send the server IP
|User-agent||The user agent of the browser||&uagent= Dalvik%2f2.1.0+(Li|
|This is mandatory for server side|
|s2s=1||This parameter indicates for a server-to-server integration||&s2s=1||This is manadatory for s2s integrations. Adding this to the API call will add a new field in the JSON response - "market_url"|
|sp||You can pass the package name of the advertiser that you would like to receive an offer for - In addition, we can receive other offers for packages in the same category||&sp=com.zhiliaoapp.musically||Optional|
An example of an API call -
Each parameter added to the API string should be added with the “&” symbol.
This symbol is used in order to differentiate one parameter from another.
When using multiple categories, make sure to use the following format:
Categories with 2 words, for example - Arcade & Action must be encoded in
the following format: Arcade%20%26%20Action
Make sure to perform a new API call whenever you want to load an ad.
Avoid making any client-side caching of the API response.
Each campaign includes a Campaign ID and a Banner ID. If an app is
promoted by several advertisers, Appnext API will only return the campaign
with the highest bid, for the asked GEO.
The Campaign ID may also change in case the advertiser chooses to A/B
test several creative. If the Campaign ID and/or the Banner ID has changed
from one API call to the next, make sure to replace all returned parameters
(including image and tracking links) and serve the most recent banner.
Updated 2 years ago