API parameters

API Key

parameter: api_key REQUIRED (string)

description: Your public API KEY, you can find it on your app details inside your Wannads account.

API secret

parameter: api_secret REQUIRED (string)

description: Your private API secret, you can find it on your app details inside your Wannads account.

http://api.wannads.com/v2/offers?api_key=[API_KEY]&api_secret=[API_SECRET]

Device

parameter: device REQUIRED (string)

description: Filters the list of offers to show the offers available to that device. More than one device at the same time can be sent (comma separated).

example: &device=iphone,ipad

Category

parameter: category OPTIONAL (string)

description: Filter the offers by selected category. More than one category at the same time can be sent (comma separated). Empty value will retrieve all categories.

example: &category=dailysurveys,surveys

COUNTRY

parameter: country **REQUIRED (string)

description: Filters the list of offers to show just the offers available for that country. If the optional parameters sub_id and IP are included, this one is ignored and the country is obtained with the IP. Value must be an ISO2.

example: &country=ES

IP

parameter: IP **REQUIRED (string)

description: IP of the user.

User ID

parameter: sub_id **REQUIRED (string)

description: Corresponds to your unique user identifier. If this parameter is included with the IP optional parameter the query will be filtered to show only the offers not completed by that user or IP.

example: &ip=83.46.33.139&sub_id=7c32fd83cc020a51d42d74e113d97257

Fingerprint

parameter: fingerprint OPTIONAL (string)

description: Fingerprint of the user browser. Use Valve/fingerprintjs2 library to calculate it.

example: &fingerprint=0d03c60c6759ab21df9b1e37b01efa4c

Age

parameter: age OPTIONAL (integer)

description: Age of the user.

example: &age=21

Gender

parameter: gender OPTIONAL (string)

description: Filters the list of offers to show the ones availables only to that gender.

example: &gender=male

Paid offers

parameter: payment OPTIONAL (string)

description: Filters the offers to show only the offers that require or not a payment. Empty for all.

example: &payment=no