Introduction
Affise.com API 3.0 documentation.
Authorization
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" http://YOUR_API_DOMAIN/
or
curl http://YOUR_API_DOMAIN/some_path?API-Key=23df424b0a53b0899f78685966243ee61
For data exchange using authentication public key passed as parameter in the header API-Key. As the key, a hash generated for your site. API key, you can see in your profile.
Personal API-Key For Affiliate
Statistics
Custom statistics
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/custom?slice[]=year&slice[]=month&slice[]=day&filter[date_from]=2017-03-01&filter[date_to]=2017-03-01&conversionTypes[]=total&conversionTypes[]=confirmed
Response example:
{
"status": 1,
"stats": [
{
"slice": {
"year": 2017,
"month": 3,
"day": 1
},
"traffic": {
"raw": "1607530",
"uniq": "1468939"
},
"actions": {
"total": {
"revenue": 1252,
"charge": 1352.52,
"earning": 100.52,
"null": 825,
"count": 1092
},
"confirmed": {
"revenue": 1252,
"charge": 1352.52,
"earning": 100.52,
"null": 728,
"count": 995
}
}
}
],
"pagination": {
"per_page": 100,
"total_count": 1,
"page": 1
}
}
Get custom statistics
GET /3.0/stats/custom
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| slice | Array[string] | Available: hour, month, quarter, year, day, offer, country, city, os, os_version, device, device_model, browser, goal, sub1, sub2, sub3, sub4, sub5. Only for admin: advertiser, affiliate, manager, smart_id |
REQUIRED Custom stats slice |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub number 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub number 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub number 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub number 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub number 5 | |
| filter[device] | Mixed: String or Array[string] | Device | |
| filter[smart_id] | Mixed: String or Array[smart_id] | Allowed only when the smart slice selected SmartLink categories ID’s | |
| filter[nonzero] | Integer | Available: 1, 0 | Non-zero conversions |
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| conversionTypes | Array[string] | Available: total, confirmed, pending, declined, hold, not_found | Only this conversion types will be output |
| page | Integer | Default: 1 | Page of stat entities |
| limit | Integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| order | Array[string] | Available: hour, month, quarter, year, day, currency, offer, country, city, os, os_version, device, device_model, browser, goal, sub1, sub2, sub3, sub4, sub5, confirmed_earning, raw, uniq, total_count, total_revenue, total_null, pending_count, pending_revenue, declined_count, declined_revenue, hold_count, hold_revenue, confirmed_count, confirmed_revenue. Only for admin: advertiser, affiliate, manager |
Sort by field |
| timezone | string | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
Conversions
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/conversions?action_id=&clickid=&country[0]=US¤cy=125&custom_field_1=&custom_field_2=&custom_field_3=&custom_field_4=&custom_field_5=&custom_field_6=&custom_field_7=&date_from=01-05-2017&date_to=01-07-2017&limit=1&page=1&payouts=&revenue=&timezone=Asia/Tokyo"
Response example:
{
"status":1,
"conversions":[
{
"id":"59359e1d7e28feb7568b456a",
"action_id":"59359dcb7e28fee0558b4567",
"status":"confirmed",
"currency":"USD",
"goal":null,
"country":"US",
"district":"",
"city":"New York",
"ip":"127.0.0.1",
"browser":"Chrome 58.0.3029",
"os":"Mac OS X 10.12.5",
"device":"Other",
"offer":{ // Will return null if the offer doesn't exist
"id":934,
"offer_id":"59313e097960ad2774b4f274",
"title":"HD-smart [Web]",
"preview_url":"http:\/\/affise.com\/1\/"
},
"offer_id":"934",
"ios_idfa":"",
"android_id":"",
"sub1":"",
"sub2":"",
"sub3":"",
"sub4":"",
"sub5":"",
"custom_field_1":"",
"custom_field_2":"",
"custom_field_3":"",
"custom_field_4":"",
"custom_field_5":"",
"custom_field_6":"",
"custom_field_7":"",
"ua":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/58.0.3029.110 Safari\/537.36",
"comment":"",
"created_at":"2017-06-06 03:08:29",
"click_time":"2017-06-06 03:07:07",
"referrer":"http://affise.com",
"payouts":1234,
"clickid":"59359dcb7e28fee0558b4567",
"partner":{
"id":610,
"email":"example@gmail.com",
"login":"example",
"name":""
},
"goal_value":"1",
"sum":0,
"revenue":12345,
"earnings":11111,
"advertiser":{
"id":"56cc49dc3b7d9b89058b45f0",
"title":"Example"
},
"payment_status":"opened",
"is_paid":"1",
"forensiq":null,
"payment_type":null,
"hold_date_expire":null
}
],
"pagination":{
"per_page":1,
"total_count":17,
"page":1,
"next_page":2
}
}
Get conversions
GET /3.0/stats/conversions
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: YYYY-MM-DD Default: day one week ago | Date from |
| date_to | String | Available: YYYY-MM-DD Default: date now | Date to |
| update_from_date | String | Available: YYYY-MM-DD | Last update date point |
| update_from_hour | Between 0 and 23 | Last update hour point | |
| status | Array[integer] | Available: 1, 2, 3, 4, 5 | Status conversions. 1 = confirmed, 2 = pending, 3 = declined, 4 = not_found, 5 = hold |
| offer | Array[integer] | Offer ID collection | |
| advertiser | Array[string] | Advertiser ID collection | |
| country | Array[string] | Countries codes. Example: “US” | |
| browser | String | Browser | |
| action_id | String | Cbid | |
| clickid | String | Click ID | |
| os | String | Os | |
| goal | String | Goal | |
| device | String | Available: tablet, desktop, mobile | Device |
| payouts | Float | Payout for affiliate | |
| currency | Integer | ID currency | |
| hour | Integer | Between 0 and 23 | Hour point Allows only for one day period |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| custom_field_1 | String | Custom field 1 | |
| custom_field_2 | String | Custom field 2 | |
| custom_field_3 | String | Custom field 3 | |
| custom_field_4 | String | Custom field 4 | |
| custom_field_5 | String | Custom field 5 | |
| custom_field_6 | String | Custom field 6 | |
| custom_field_7 | String | Custom field 7 | |
| subid1 | String | Sub 1 | |
| subid2 | String | Sub 2 | |
| subid3 | String | Sub 3 | |
| subid4 | String | Sub 4 | |
| subid5 | String | Sub 5 | |
| partner | Array[integer] | ONLY FOR ADMIN Affiliates |
|
| revenue | Float | ONLY FOR ADMIN Revenue | |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
Clicks
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/clicks?date_from=2017-05-01&date_to=2017-07-31&limit=1
Response example:
{
"status":1,
"clicks":[
{
"id":"59359dcb7e28fee0558b4567",
"ip":"127.0.0.1",
"ua":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/58.0.3029.110 Safari\/537.36",
"country":"US",
"city":"New York",
"device":"Other",
"os":"Mac OS X 10.12.5",
"browser":"Chrome 58.0.3029",
"referrer":"",
"sub1":"",
"sub2":"",
"sub3":"",
"sub4":"",
"sub5":"",
"offer":{
"id":934,
"offer_id":"59313e097960ad2774b4f274",
"title":"HD-smart [Web]"
},
"conversion_id":"59359e1d7e28feb7568b456a",
"ios_idfa":"",
"android_id":"",
"created_at":"2017-06-06 03:07:07",
"uniq":1,
"cbid":"59359dcb7e28fee0558b4567",
"partner_id":"610"
}
],
"pagination":{
"per_page":1,
"total_count":25,
"page":1,
"next_page":2
}
}
Get clicks
GET /3.0/stats/clicks
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: YYYY-MM-DD | REQUIRED |
| date_to | String | Available: YYYY-MM-DD | REQUIRED |
| hour | Integer | Between 0 and 23 | Hour point Allows only for one day period |
| offer | Array[integer] | Offer ID’s | |
| partner | Array[integer] | Affiliates ID’s | |
| country | Array[string] | Countries codes. Example: “US” | |
| advertiser | Array[string] | ONLY FOR ADMIN Advertiser ID collection | |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
By date
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbydate?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"year":2017,
"month":5,
"day":31
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":8,
"page":1,
"next_page":2
}
}
Get statistics by date
GET /3.0/stats/getbydate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[device] | Mixed: String or Array[string] | Device |
Hourly
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyhour?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"year":2017,
"month":5,
"day":31,
"hour":0
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"confirmed":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
}
}
}
],
"pagination":{
"per_page":1,
"total_count":24,
"page":1,
"next_page":2
}
}
Get statistics by hour
GET /3.0/stats/getbyhour
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By sub
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbysub?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&filter[offer]=1&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"sub1":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by sub
GET /3.0/stats/getbysub
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | REQUIRED Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By offer
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyprogram?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"offer":{
"id":906,
"offer_id":"59313e127960ad2774b4f2b9",
"title":"HD-smart [Web]"
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by offer
GET /3.0/stats/getbyprogram
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By advertiser
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyadvertiser?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"advertiser":{
"id":"56cc49dc3b7d9b89058b45f0",
"title":"advertiser"
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by advertiser
GET /3.0/stats/getbyadvertiser
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Partners ID’s. | |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By accounts managers
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyadvertiser?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"advertiser_manager_id":{
"id":0,
"first_name":"Undefined",
"last_name":"Undefined"
}
},
"traffic":{
"raw":"9",
"uniq":"1"
},
"actions":{
"confirmed":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"declined":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"hold":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"not_found":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"pending":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"total":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
}
}
},
{
"slice":{
"advertiser_manager_id":{
"id":"57b1b91f47c449e70a8b4567",
"first_name":"tab",
"last_name":"GmbH"
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"confirmed":{
"charge":1.5874,
"earning":0.1587,
"null":3,
"revenue":1.4286,
"count":4
},
"declined":{
"charge":0,
"earning":0,
"null":2,
"revenue":0,
"count":2
},
"hold":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"not_found":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"pending":{
"charge":1.5874,
"earning":0.1587,
"null":0,
"revenue":1.4286,
"count":1
},
"total":{
"charge":3.1747,
"earning":0.3175,
"null":5,
"revenue":2.8572,
"count":7
}
}
}
],
"pagination":{
"per_page":100,
"total_count":2,
"page":1
}
}
Get statistics by accounts managers
GET /3.0/stats/getbyaccountmanager
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Partners ID’s. | |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By affiliates managers
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyaffiliatemanager?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"affiliate_manager_id":{
"id":"0",
"first_name":"Undefined",
"last_name":"Undefined"
}
},
"traffic":{
"raw":"9",
"uniq":"1"
},
"actions":{
"confirmed":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"declined":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"hold":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"not_found":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"pending":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"total":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
}
}
},
{
"slice":{
"affiliate_manager_id":{
"id":"57b1b91f47c449e70a8b4567",
"first_name":"tab",
"last_name":"GmbH"
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"confirmed":{
"charge":1.5874,
"earning":0.1587,
"null":3,
"revenue":1.4286,
"count":4
},
"declined":{
"charge":0,
"earning":0,
"null":2,
"revenue":0,
"count":2
},
"hold":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"not_found":{
"charge":0,
"earning":0,
"null":0,
"revenue":0,
"count":0
},
"pending":{
"charge":1.5874,
"earning":0.1587,
"null":0,
"revenue":1.4286,
"count":1
},
"total":{
"charge":3.1747,
"earning":0.3175,
"null":5,
"revenue":2.8572,
"count":7
}
}
}
],
"pagination":{
"per_page":100,
"total_count":2,
"page":1
}
}
Get statistics by affiliates managers
GET /3.0/stats/getbyaffiliatemanager
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /3.0/admin/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Partners ID’s. | |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbypartner?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"affiliate":{
"id":610,
"email":"aff@iliate.com",
"login":"affiliate",
"name":""
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by affiliate
GET /3.0/stats/getbypartner
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Partners ID’s. | |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By affiliate and date
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbypartnerbydate?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"year":2017,
"month":5,
"day":31,
"affiliate":{
"id":610,
"email":"affiliate@affiliate.com",
"login":"affiliate",
"name":""
}
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by affiliate and date
GET /3.0/stats/getbypartnerbydate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Partners ID’s. | |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By country
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbycountries?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"country":"USA"
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by country
GET /3.0/stats/getbycountries
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By browser
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbybrowsers?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"browser":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by browser
GET /3.0/stats/getbybrowsers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By OS
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyos?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"os":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by OS
GET /3.0/stats/getbyos
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By OS version
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyversions?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"os":"",
"os_version":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by os version
GET /3.0/stats/getbyversions
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By goal
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbygoal?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"goal":"1"
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by goal
GET /3.0/stats/getbygoal
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By city
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbycities?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"city":0
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by city
GET /3.0/stats/getbycities
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By device
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbydevices?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"device":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by device
GET /3.0/stats/getbydevices
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
By device model
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbydevicemodels?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"device_model":""
},
"traffic":{
"raw":"0",
"uniq":"0"
},
"actions":{
"total":{
"revenue":191190.40796039,
"charge":339894.05859619,
"earning":148703.65063587,
"null":0,
"count":12600
},
"confirmed":{
"revenue":15.173841901617,
"charge":26.975718936208,
"earning":11.801877034591,
"null":0,
"count":1
},
"pending":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"declined":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"not_found":{
"revenue":0,
"charge":0,
"earning":0,
"null":0,
"count":0
},
"hold":{
"revenue":191175.23411849,
"charge":339867.08287725,
"earning":148691.84875883,
"null":0,
"count":12599
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by device model
GET /3.0/stats/getbydevicemodels
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en Available: ru, en, es |
Locale for output a cities data when you use the city slice |
| timezone | String | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
| orderType | String | Default: asc Available: asc, desc |
Sorting order |
| filter[date_from] | String | Available: YYYY-MM-DD | REQUIRED Date from |
| filter[date_to] | String | Available: YYYY-MM-DD | REQUIRED Date to |
| filter[currency] | Array[string] | Default: All currencies code | The list of a currencies code you can get from API /2.1/currencies |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Mixed: Integer or Array[integer] | Offers ID’s | |
| filter[manager] | Mixed: String or Array[string] | Managers ID’s | |
| filter[partner] | Mixed: String or Array[string] | Default: If the request from not an admin then default a ID partner | ONLY FOR ADMIN Partners ID’s. |
| filter[country] | Mixed: String or Array[string] | Countries codes. Example: “US” | |
| filter[os] | Mixed: String or Array[string] | Os | |
| filter[goal] | Mixed: String or Array[string] | Goal | |
| filter[sub1] | Mixed: String or Array[string] | Sub 1 | |
| filter[sub2] | Mixed: String or Array[string] | Sub 2 | |
| filter[sub3] | Mixed: String or Array[string] | Sub 3 | |
| filter[sub4] | Mixed: String or Array[string] | Sub 4 | |
| filter[sub5] | Mixed: String or Array[string] | Sub 5 | |
| filter[sub5] | Mixed: String or Array[string] | Device |
Find subs
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/find-subs?sub1=1
Response example:
{
"status":1,
"subs":[
{
"sub1":"test1"
}
],
"pagination":{
"per_page":100,
"total_count":0,
"page":1
}
}
Get sub accounts
GET /3.0/stats/find-subs
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| sub1 | String | Sub 1 | |
| sub2 | String | Sub 2 | |
| sub3 | String | Sub 3 | |
| sub4 | String | Sub 4 | |
| sub5 | String | Sub 5 | |
| page | integer | Default: 1 | Page of sub entities |
| limit | integer | Default: 100 | Limit of sub entities |
By server postback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/serverpostbacks?date_from=01-04-2017&date_to=01-07-2017&offer[0]=59313e087960ad2774b4f269&partner[0]=610&search=610&click_id=59359dcb7e28fee0558b4567&goal=1
Response example:
{
"status":1,
"postbacks":[
{
"_id":{
"$id":"59359e1d7e28feb7568b4569"
},
"_get":{
"clickid":"59359dcb7e28fee0558b4567"
},
"_post":[
],
"date":{
"sec":1496686109,
"usec":35000
},
"get":"{\u0022clickid\u0022:\u002259359dcb7e28fee0558b4567\u0022}",
"post":"[]",
"server":"127.0.0.1",
"response":"{\n \u0022status\u0022: 1\n}",
"track":{
"id":"59359dcb7e28fee0558b4567",
"ip":"127.0.0.1",
"ua":"Mozilla\/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit\/537.36 (KHTML, like Gecko) Chrome\/58.0.3029.110 Safari\/537.36",
"country":"US",
"city":"New York",
"device":"Other",
"os":"Mac OS X 10.12.5",
"browser":"Chrome 58.0.3029",
"offer":{
"id":934,
"offer_id":"59313e097960ad2774b4f274",
"title":"HD-smart [Web]",
"preview_url":"http:\/\/affise.com\/desktop\/1\/"
},
"referrer":"",
"click_id":"59359dcb7e28fee0558b4567",
"sub1":"",
"sub2":"",
"sub3":"",
"sub4":"",
"sub5":"",
"offer_id":"934",
"conversion_id":null,
"ios_idfa":null,
"android_id":null,
"created_at":"2017-06-06 03:07:07",
"uniq":1,
"cbid":null,
"partner":{
"id":"610",
"login":"affiliate",
"email":"affi@lia.te"
}
}
}
],
"pagination":{
"per_page":100,
"total_count":1,
"page":1
}
}
Get server postbacks
GET /3.0/stats/serverpostbacks
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: YYYY-MM-DD | REQUIRED |
| date_to | String | Available: YYYY-MM-DD | REQUIRED |
| offer | Array[string] | Offers ID’s | |
| partner | Array[integer] | Partners ID’s. | |
| action_id | String | Action id | |
| click_id | String | Click id | |
| goal | String | Goal | |
| status | String | Status | |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
By partner postback
curl -X GET \
'http://<YOUR_DOAMIN>/3.0/stats/affiliatepostbacks?date_from=2017-11-25&date_to=2017-11-28&partner%5B%5D=2&goal=1&http_code=200' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
Response example:
{
"status": 1,
"postbacks": [
{
"_id": {
"$id": "5a1d248f1bfa2441008b4567"
},
"_get": null,
"_post": null,
"date": {
"sec": 1511859343,
"usec": 662000
},
"pid": 2,
"lead_id": "5a1d247cbbf68e0001972d26",
"http_code": 200,
"postback_url": "http://dsda.com",
"offer_id": "5a1d23641bfa2418008b4567",
"job_id": "5a1d248a1bfa2418008b456b",
"goal": "1",
"status": 1
}
],
"pagination": {
"per_page": 100,
"total_count": 1,
"page": 1
}
}
Get partner postbacks
GET /3.0/stats/affiliatepostbacks
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: YYYY-MM-DD | REQUIRED |
| date_to | String | Available: YYYY-MM-DD | REQUIRED |
| offer | Array[string] | Offers ID’s | |
| partner | Array[integer] | Partners ID’s. | |
| goal | String | Goal | |
| status | String | Status | |
| http_code | String | Http code | |
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of stat entities |
By cap
curl -X GET \
'http://<YOUR_DOAMIN>/3.0/stats/caps?offer_id[]=10' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
Response example:
{
"status":1,
"offers":{
"890":{
"descr":{
"daily_conversions":"0062118c81231bee06313939a860d81a",
"total_conversions":"0c1c2e00e0de14135c9d456fe66e0106"
},
"stats":{
"0062118c81231bee06313939a860d81a":[
{
"affiliate_id":0, //0 - means all affiliates
"goal":"2",
"cap_val":10,
"cur_val":1
}
],
"0c1c2e00e0de14135c9d456fe66e0106":[
{
"affiliate_id": 600,
"goal":"2",
"cap_val":50,
"cur_val":45
}
],
},
"stats_merged":{
"0062118c81231bee06313939a860d81a":{
"cap_val":10,
"min":1,
"max":10,
"avg":5
}
}
}
}
}
Get stats by cap
GET /3.0/stats/caps
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Array[string] | REQUIRED Offers ID’s. Possibly a maximum of 100 ID’s. | |
| fields | Array[string] | Available : stats, stats_merged, descr | REQUIRED Fields for each offer in response. |
| affiliate_id | Array[integer] | Affiliates filter |
Fields description:
* stats - contains full stat for each cap
* stats_merged - contains min,avg,max calculated from statistics for each cap when cap contains several metrics (ex: limit for each affiliate or cap contains several goals)
* descr - contains string descriptions like “daily_conversions” / “total_conversions” for each cap
Ratention rate
curl -X GET \
'http://<YOUR_DOAMIN>/3.0/stats/retentionrate?date_from=2018-10-16&date_to=2018-10-19&offer_id=28&base_event=install
&events=install,other1,other2&timezone=Europe/Moscow&affiliate_id=1' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
Response example:
[
{
"affiliate_id": 1,
"date": "2018-10-18",
"rr_install": 66.66,
"rr_other1": 100,
"rr_other2": 33.33,
"install_count": 3
},
{
"affiliate_id": 1,
"date": "2018-10-19",
"rr_install": 0,
"rr_other1": 100,
"rr_other2": 0,
"install_count": 1
}
]
Get stats retentionrate
GET /3.0/stats/retentionrate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: YYYY-MM-DD | REQUIRED Date from |
| date_to | String | Available: YYYY-MM-DD | REQUIRED Date to |
| offer | Integer | REQUIRED | |
| goal | string | REQUIRED Name based goal | |
| events | Array[string] | REQUIRED events | |
| affiliate_id | integer | Affiliates filter | |
| timezone | string | Default: Timezone of your platform | Timezone name. Example: “Europe/Berlin” |
Fields description:
* goal - contains name based goal
* events - event list comma separated
Affiliate methods
Offer list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/offers
Response example:
{
"status":1,
"offers":[
{
"id":902,
"offer_id":"5718dac83b7d9bf8588b4579",
"title":"...",
"preview_url":"....",
"description":"...",
"cr":199850,
"epc":298988.33,
"logo":"http:\/\/affise.admin\/images\/cpa\/logos\/2602108452.png",
"stop_at":"",
"sources":[
{
"id":"51f531f53b7d9b1e0382f6d9",
"title":"Web sites",
"allowed":1
}
],
"categories":[
"..."
],
"full_categories":[
{
"id":"5368afb23b7d9b4d5d505342",
"title":"..."
}
],
"countries":[
"us"
],
"payments":[
{
"countries":[
"US"
],
"cities":[
],
"country_exclude":false,
"title":"...",
"goal":"1",
"revenue":150,
"currency":"USD",
"type":"fixed",
"devices":[
],
"os":[
]
}
],
"required_approval":true,
"landings":[
],
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"links":[
{
"id":null,
"title":null,
"hash":null,
"url":"http:\/\/affise.tds\/click?pid=610\u0026offer_id=902",
"postbacks":[
],
"created":null
}
],
"macro_url":null,
"link":"http:\/\/affise.tds\/click?pid=610\u0026offer_id=902",
"use_https":false,
"use_http":true,
"hold_period":0,
"caps": [
{
"period": "day",
"type": "conversions",
"value": 100,
"goal_type": "exact",
"goals": {
"1" : "Install",
"2" : "Register"
}
},
{
"period": "month",
"type": "budget",
"value": 100,
"goal_type": "each",
"goals": {}
},
{
"period": "all",
"type": "budget",
"value": 100,
"goal_type": "all",
"goals": {}
}
]
}
],
"pagination":{
"per_page":1,
"total_count":127,
"page":1,
"next_page":2
}
}
Get list of available partner offers
GET /3.0/partner/offers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| q | String | Search by title and id | |
| ids | Array[string] | Search by string offer ID | |
| int_id | Array[integer] | Search by int offer ID | |
| countries | Array[string] | Array of offers countries(ISO) | |
| categories | Array[string] | Array of offers categories | |
| sort | Array[string] | Sort offers. Sample sort[id]=asc, sort[title]=desc. You can sort offers by one of (id, title, cr, epc) | |
| page | Integer | Page of offers | |
| limit | Integer | Count offers by page |
Live offer list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/live-offers
Response example:
{
"status":1,
"offers":[
{
"id":902,
"offer_id":"5718dac83b7d9bf8588b4579",
"title":"...",
"preview_url":"....",
"description":"...",
"cr":199850,
"epc":298988.33,
"logo":"http:\/\/affise.admin\/images\/cpa\/logos\/2602108452.png",
"stop_at":"",
"sources":[
{
"id":"51f531f53b7d9b1e0382f6d9",
"title":"Web sites",
"allowed":1
},
{
"id":"51f532103b7d9b340e325f1c",
"title":"Context AD",
"allowed":1
},
{
"id":"51f532393b7d9b5e030908a0",
"title":"Teaser\/banner AD",
"allowed":1
},
{
"id":"51f532713b7d9b5e03b24520",
"title":"Social networks: publics, games, applications",
"allowed":1
},
{
"id":"51f532873b7d9b5e03e88a74",
"title":"Emailing",
"allowed":1
}
],
"categories":[
"..."
],
"full_categories":[
{
"id":"5368afb23b7d9b4d5d505342",
"title":"..."
}
],
"countries":[
"us"
],
"payments":[
{
"countries":[
"US"
],
"cities":[
],
"country_exclude":false,
"title":"...",
"goal":"1",
"revenue":150,
"currency":"USD",
"type":"fixed",
"devices":[
],
"os":[
]
}
],
"required_approval":true,
"landings":[
],
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"links":[
{
"id":null,
"title":null,
"hash":null,
"url":"http:\/\/affise.tds\/click?pid=610\u0026offer_id=902",
"postbacks":[
],
"created":null
}
],
"macro_url":null,
"link":"http:\/\/affise.tds\/click?pid=610\u0026offer_id=902",
"use_https":false,
"use_http":true,
"hold_period":0,
"caps": [
{
"period": "day",
"type": "conversions",
"value": 100,
"goal_type": "exact",
"goals": {
"1" : "Install",
"2" : "Register"
}
},
{
"period": "month",
"type": "budget",
"value": 100,
"goal_type": "each",
"goals": {}
},
{
"period": "all",
"type": "budget",
"value": 100,
"goal_type": "all",
"goals": {}
}
]
}
],
"pagination":{
"per_page":1,
"total_count":127,
"page":1,
"next_page":2
}
}
Get list of a live offers
GET /3.0/partner/live-offers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| q | String | Search by title and id | |
| ids | Array[string] | Search by string offer ID | |
| int_id | Array[integer] | Search by int offer ID | |
| countries | Array[string] | Array of offers countries(ISO) | |
| categories | Array[string] | Array of offers categories | |
| sort | Array[string] | Sort offers. Sample sort[id]=asc, sort[title]=desc. You can sort offers by one of (id, title, cr, epc) | |
| page | Integer | Page of offers | |
| limit | Integer | Count offers by page |
Activation offer
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "offer_id=123&comment=test" http://YOUR_API_DOMAIN/3.0/partner/activation/offer
Response example:
{
"status":1,
"message":"Request is successfully"
}
Connect to an offer
POST /3.0/partner/activation/offer
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Integer | REQUIRED | |
| comment | String | REQUIRED |
Add postback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "url=http://affise.com&status=by_creating&offer_id=906" http://YOUR_API_DOMAIN/3.0/partner/postback
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"by_creating",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Add postback
POST /3.0/partner/postback
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| pid | Integer | REQUIRED (for role admin case) Example: 25 | |
| offer_id | Integer | Offer ID (missed parameter means creation of global postback) | |
| url | String | REQUIRED Example: http://affise.com | |
| status | String | Available: by_creating, confirmed, pending, declined, hold, not_found | Postback status |
| goal | String | Postback goal |
Edit postback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "url=http://affise.com&status=confirmed&offer_id=906" http://YOUR_API_DOMAIN/3.0/partner/postback/960
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"confirmed",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Edit postback
POST /3.0/partner/postback/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| pid | Integer | REQUIRED (for role admin case) Example: 25 | |
| url | String | REQUIRED Example: http://affise.com | |
| status | String | Available: by_creating, confirmed, pending, declined, hold, not_found | Postback status |
| goal | String | Postback goal |
Delete postback
curl -X DELETE --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/postback/960/remove
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"confirmed",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Delete postback
DELETE /3.0/partner/postback/{ID}/remove
News list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/news
Response example:
{
"status":1,
"items":{
"57a4914f3b7d9bbd358b45b6":{
"_id":{
"$id":"57a4914f3b7d9bbd358b45b6"
},
"title":"Title news",
"small_desc":"....",
"desc":"....",
"status":1,
"created_at":{
"sec":1470402895,
"usec":891000
}
}
},
"all_items":334
}
News list
GET /3.0/news
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| limit | Integer | Available: max 100 Default: 10 |
|
| skip | Integer | Default: 0 | Offset |
| fixed | Integer | Available: 1, 0 | 1 - pinned, 0 - not pinned |
News get by ID
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/news/57a4914f3b7d9bbd358b45b6
Response example:
{
"status":1,
"news":{
"_id":{
"$id":"57a4914f3b7d9bbd358b45b6"
},
"title":"...",
"small_desc":"....",
"desc":"....",
"status":1,
"created_at":{
"sec":1470402895,
"usec":891000
}
}
}
Get news by ID
GET /3.0/news/{ID}
Pixel list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/pixels
Response example:
{
"status":1,
"pixel":{
"1":{
"id":1,
"name":"...",
"code":"\u003Cscript\u003Ealert(\u0027123\u0027);\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-19 22:49:07",
"updated_at":"2017-06-19 22:49:07"
}
}
}
Get list of a partner’s pixels
GET /3.0/partner/pixels
Pixel add
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "pid=610&offer_id=906&name=test&code=<script>test</script>&code_type=javascript" http://YOUR_API_DOMAIN/3.0/partner/pixel
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test",
"code":"\u003Cscript\u003Etest\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Add a partner’s pixel
POST /3.0/partner/pixel
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Integer | REQUIRED Offer’s ID | |
| name | String | REQUIRED Name | |
| code | String | Available: <script>…code…</scipt>, <img …>, <iframe src=“…”></iframe> | REQUIRED Code |
| code_type | String | Available: javascript, iframe, image | REQUIRED Code type |
Pixel edit
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "pid=610&offer_id=906&name=test2&code=<script>test2</script>&code_type=javascript" http://YOUR_API_DOMAIN/3.0/partner/pixel/2
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test2",
"code":"\u003Cscript\u003Etest2\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Edit a partner’s pixel
POST /3.0/partner/pixel/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | Name | |
| code | String | Available: <script>…code…</scipt>, <img …>, <iframe src=“…”></iframe> | Code |
| code_type | String | Available: javascript, iframe, image | Code type |
Pixel remove
curl -X DELETE --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/pixel/2/remove
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test2",
"code":"\u003Cscript\u003Etest2\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Delete a partner’s pixel
DELETE /3.0/partner/pixel/{ID}/remove
Affiliate balance
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/balance
Response example:
{
"status":1,
"balance":{
"balance":{
"USD":0,
"EUR":0,
"RUB":16968
},
"hold":{
"USD":0,
"EUR":0,
"RUB":1234
},
"available":{
"USD":0,
"EUR":0,
"RUB":15734
}
}
}
Get current affiliate balance
GET /3.0/balance
Offers
Offers list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/offers
Response example:
{
"status":1,
"offers":[
{
"id":331,
"offer_id":"542846883cd97f64a79415c5",
"title":"...",
"preview_url":"",
"description":"",
"cr":366.67,
"epc":1466.67,
"logo":"http:\/\/affise.admin\/images\/cpa\/logos\/787450449.jpeg",
"stop_at":"",
"sources":[
{
"id":"51f531f53b7d9b1e0382f6d9",
"title":"Web sites",
"allowed":1
}
],
"categories":[
"...",
"..."
],
"full_categories":[
{
"id":"5368afb23b7d9b4d5d505342",
"title":"..."
},
{
"id":"55b204663b7d9b460b8b45b2",
"title":"..."
}
],
"countries":[
"us"
],
"payments":[
{
"countries":[
"US"
],
"cities":[
],
"country_exclude":false,
"title":"...",
"goal":"1",
"revenue":400,
"currency":"USD",
"type":"fixed",
"devices":[
],
"os":[
]
}
],
"caps": [
{
"period": "day",
"type": "conversions",
"value": 100,
"goal_type": "exact",
"goals": {
"1" : "Install"
},
"affiliate_type" : "exact",
"affiliates": [500, 600]
},
{
"period": "month",
"type": "budget",
"value": 100,
"goal_type": "each",
"goals": [],
"affiliate_type" : "each",
"affiliates": []
},
{
"period": "all",
"type": "budget",
"value": 100,
"goal_type": "all",
"goals": [],
"affiliate_type" : "all",
"affiliates": []
}
],
"required_approval":true,
"landings":[
{
"id":1,
"title":"...",
"url":"http:\/\/affise.com\/l1\/",
"url_preview":"http:\/\/affise.com\/l1\/",
"type":"landing"
}
],
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"sub_accounts": {
"1" : {
"value": "",
"except": false
},
"2" : {
"value": "",
"except": false
}
},
"kpi": {
"ru": "",
"en": "",
"es": "",
"ka": ""
}
}
],
"pagination":{
"per_page":1,
"total_count":176,
"page":1,
"next_page":2
}
}
Get a list of offers
GET /3.0/offers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| q | String | Search by title and id | |
| ids | Array[string] | Search by string offer ID | |
| int_id | Array[integer] | Search by int offer ID | |
| countries | Array[string] | Array of offers countries(ISO) | |
| os | Array[string] | Available: web, wp, ios, android | OS |
| categories | Array[string] | Array of offers categories | |
| sort | Array[string] | Sort offers. Sample sort[id]=asc, sort[title]=desc. You can sort offers by one of (id, title, cr, epc) | |
| page | Integer | Page of offers | |
| limit | Integer | Count offers by page | |
| status | Array[string] | Default: active Available: active, stopped, suspended |
ONLY FOR ADMIN |
| advertiser | Array[String] | ONLY FOR ADMIN Advertiser ID | |
| privacy | Array[integer] | ONLY FOR ADMIN Privacy filter: Public(0), Premoderated(1), Private(2) |
Offer by id
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/offer/906
Response example:
{
"status":1,
"offer":{
"id":906,
"offer_id":"5721f8e03b7d9b7f058b4568",
"advertiser":"56cc49dc3b7d9b89058b45f0",
"hide_payments":false,
"title":"...",
"macro_url":"",
"url":"http:\/\/...\/desktop\/1\/?w=32\u0026t=...\u0026a1={clickid}\u0026a5={pid}",
"url_preview":"http:\/\/...\/desktop\/1\/",
"preview_url":"http:\/\/...\/desktop\/1\/",
"domain_url":"affise.tds",
"use_https":false,
"use_http":true,
"description":"...",
"countries":[
],
"sources":[
"51f531f53b7d9b1e0382f6d9",
"51f532053b7d9b340eea741a",
"51f532103b7d9b340e325f1c",
"51f5322d3b7d9b340eabb872",
"51f532393b7d9b5e030908a0",
"51f5325e3b7d9b340e8a2b79",
"51f532713b7d9b5e03b24520",
"51f532873b7d9b5e03e88a74",
"5432ffe43b7d9b615f4f7f2a",
"5432fff93b7d9b615fab559d"
],
"logo":"\/images\/cpa\/logos\/4228614618.png",
"status":"active",
"freshness":"default",
"privacy":"public",
"is_top":1,
"payments":[
{
"countries":[
],
"cities":[
],
"devices":[
],
"os":[
],
"goal":"1",
"total":1020,
"revenue":800,
"currency":"rub",
"goal_alias":null,
"title":"...",
"type":"fixed",
"url":null,
"country_exclude":false,
"with_regions":false
},
{
"countries":[
],
"cities":[
],
"devices":[
],
"os":[
],
"goal":"4",
"total":1600,
"revenue":1020,
"currency":"rub",
"goal_alias":null,
"title":"...",
"type":"fixed",
"url":null,
"country_exclude":false,
"with_regions":false
},
{
"countries":[
],
"cities":[
],
"devices":[
],
"os":[
"Mac OS X"
],
"goal":"1",
"total":12345,
"revenue":1234,
"currency":"usd",
"goal_alias":null,
"title":"",
"type":"fixed",
"url":null,
"country_exclude":false,
"with_regions":false
}
],
"partner_payments":[
{
"countries":[
],
"cities":[
],
"devices":[
],
"os":[
],
"goal":"2",
"total":1600,
"revenue":900,
"currency":"usd",
"goal_alias":null,
"title":"...",
"type":"fixed",
"url":null,
"country_exclude":false,
"with_regions":false,
"partners":[
610
]
}
],
"landings":[
],
"strictly_country":0,
"strictly_os":{
"enabled":0
},
"is_redirect_overcap":true,
"notice_percent_overcap":80,
"hold_period":0,
"categories":[
"5368afb23b7d9b4d5d505342"
],
"full_categories":[
{
"id":"5368afb23b7d9b4d5d505342",
"title":"..."
}
],
"cr":1.21,
"epc":9.58,
"notes":"",
"allowed_ip":"",
"hash_password":"",
"allow_deeplink":0,
"hide_referer":false,
"start_at":"2016-03-03",
"stop_at":null,
"auto_offer_connect":0,
"required_approval":false,
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"send_emails":false,
"click_session":"1d",
"sub_accounts": {
"1" : {
"value": "",
"except": false
},
"2" : {
"value": "",
"except": false
}
},
"caps": [
{
"period": "day",
"type": "conversions",
"value": 100,
"goal_type": "exact",
"goals": {
"1" : "Install",
"2" : "Register"
},
"affiliate_type" : "exact",
"affiliates": [500, 600]
},
{
"period": "month",
"type": "budget",
"value": 100,
"goal_type": "each",
"goals": {},
"affiliate_type" : "each",
"affiliates": []
},
{
"period": "all",
"type": "budget",
"value": 100,
"goal_type": "all",
"goals": {},
"affiliate_type" : "all",
"affiliates": []
}
]
}
}
Get full information of an offer
GET /3.0/offer/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| id | Integer |
Categories
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/offer/categories
Response example:
{
"status":1,
"categories":[
{
"id":"5368a3973b7d9b4d5d59f1ca",
"title":"..."
}
],
"pagination":{
"per_page":1,
"total_count":11,
"page":1,
"next_page":2
}
}
List of a categories
GET /3.0/offer/categories
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | Integer | Page of entities | |
| limit | Integer | Limit of entities |
Advertiser managing (admin methods)
Advertisers list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/advertisers
Response example:
{
"status":1,
"advertisers":[
{
"id":"505998ea5caf25a003000000",
"title":"....",
"contact":null,
"email":"...",
"url":"http:\/\/affise.com",
"manager":"",
"manager_obj":"",
"allowed_ip":[
],
"skype":null,
"note":null,
"hash_password":null,
"offers":"0",
"has_user":false,
"address_1": "...",
"address_2": "...",
"city": "Moscow",
"country": "RU",
"zip_code": "...",
"vat_code": "..."
}
],
"pagination":{
"per_page":100,
"total_count":183,
"page":1,
"next_page":2
}
}
Get a list of advertisers
GET /3.0/admin/advertisers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | Integer | Page of entities | |
| limit | Integer | Limit of entities | |
| order | String | Default: _id Available: _id, title, email |
Sort by field |
| orderType | String | Default: asc Available: desc, asc |
Sorting order |
Add advertiser
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=MyTitle&contact=ThePerson&skype=MySkype&manager=5747f68c3b7d9be4018b4570" http://YOUR_API_DOMAIN/3.0/admin/advertiser
Response example:
{
"status":1,
"advertiser":{
"id":"59490d317e28febe1e8b456c",
"title":"MyTitle",
"contact":"ThePerson",
"email":null,
"url":null,
"manager": "5747f68c3b7d9be4018b4570",
"manager_obj":{
"id":"5747f68c3b7d9be4018b4570",
"first_name":"...",
"last_name":"...",
"email":"...",
"skype":"...",
"roles":[
"ROLE_MANAGER_SALES",
"ROLE_ADMIN"
],
"api_key":null,
"created_at":"2016-05-27 16:26:04"
},
"allowed_ip":[
s
],
"skype":"MySkype",
"note":null,
"address_1": "...",
"address_2": "...",
"city": "Moscow",
"country": "RU",
"zip_code": "...",
"vat_code": "..."
}
}
Add new advertiser
POST /3.0/admin/advertiser
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | REQUIRED Company name | |
| contact | String | Contact person name | |
| skype | String | IM/Skype | |
| manager | String | Manager ID | |
| url | String | Site Url | |
| String | |||
| allowed_ip | String | Allowed IP. Example: 127.0.0.1\n127.0.1.1-127.0.2.1 | |
| address_1 | String | Main address string | |
| address_2 | String | Additional address | |
| city | String | City name | |
| country | String | Country ISO name | |
| zip_code | String | Zip code | |
| vat_code | String | Vat code | |
| sub_account_1 | String | Sub1 list, separated by commas | |
| sub_account_2 | String | Sub2 list, separated by commas | |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Except Sub1 list |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Except Sub2 list |
Edit advertisers
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=MyTitle2&contact=ThePerson2&skype=MySkype2&manager=5747f68c3b7d9be4018b4570" http://YOUR_API_DOMAIN/3.0/admin/advertiser/59490d317e28febe1e8b456c
Response example:
{
"status":1,
"advertiser":{
"id":"59490d317e28febe1e8b456c",
"title":"MyTitle2",
"contact":"ThePerson2",
"email":null,
"url":null,
"manager":"5747f68c3b7d9be4018b4570",
"manager_obj":{
"id":"5747f68c3b7d9be4018b4570",
"first_name":"...",
"last_name":"...",
"email":"...",
"skype":"...",
"roles":[
"ROLE_MANAGER_SALES",
"ROLE_ADMIN"
],
"api_key":null,
"created_at":"2016-05-27 16:26:04"
},
"allowed_ip":[
],
"skype":"MySkype2",
"note":null,
"address_1": "...",
"address_2": "...",
"city": "Moscow",
"country": "RU",
"zip_code": "...",
"vat_code": "..."
}
}
Change an advertiser’s data
POST /3.0/admin/advertiser/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | Company name | |
| contact | String | Contact person name | |
| skype | String | IM/Skype | |
| manager | String | Manager ID | |
| url | String | Site Url | |
| String | |||
| allowed_ip | String | Allowed IP. Example: 127.0.0.1\n127.0.1.1-127.0.2.1 | |
| note | String | Note | |
| allowed_ip | String | Allowed IP | |
| address_1 | String | Main address string | |
| address_2 | String | Additional address | |
| city | String | City name | |
| country | String | Country ISO name | |
| zip_code | String | Zip code | |
| vat_code | String | Vat code | |
| sub_account_1 | String | Sub1 list, separated by commas | |
| sub_account_2 | String | Sub2 list, separated by commas | |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Except Sub1 list |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Except Sub2 list |
Send password to advertiser
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "" http://YOUR_API_DOMAIN/3.0/admin/advertiser/59490d317e28febe1e8b456c/sendpass
Response example:
{
"status":1,
"message":"Email send successfully"
}
Change an advertiser password and send it by email
POST /3.0/admin/advertiser/{ID}/sendpass
Advertisers enable affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "advertisers_id=56fce8ab3b7d9b95588b4568&pid=610" http://YOUR_API_DOMAIN/3.0/admin/advertiser/enable-affiliate
Response example:
{
"status":1,
"message":"Request is successfully: Partner #610 doesn\u0027t exist in blacklist for advertiser 56fce8ab3b7d9b95588b4568"
}
Un-put affiliate from blacklist for specified advertisers
POST /3.0/admin/advertiser/enable-affiliate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| advertisers_id | Array[string] | REQUIRED Array of advertiser IDs to connect | |
| pid | Integer | REQUIRED affiliate ID |
Advertisers disable affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "advertisers_id=56fce8ab3b7d9b95588b4568&pid=610" http://YOUR_API_DOMAIN/3.0/admin/advertiser/disable-affiliate
Response example:
{
"status":1,
"message":"Request is successfully"
}
Put affiliate to blacklist for specified advertisers
POST /3.0/admin/advertiser/disable-affiliate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| advertisers_id | Array[string] | REQUIRED Array of advertiser IDs to connect | |
| pid | Integer | REQUIRED affiliate ID |
Advertiser billing managing (admin methods)
Invoices list
curl -X GET \
http://<YOUR_DOMAIN>/3.0/admin/advertiser-invoices \
-H 'api-key: d4735cd4fbf4ba08729cf3256c358ebefffb6f9d' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-H 'postman-token: 97d09049-050c-58ce-9eaf-5997b72f1eb2' \
Response example:
{
"status": 1,
"message": [
{
"number": 1,
"supplier_id": "5a37c01cbf0b6b18008b4567",
"created_at": "2018-01-11",
"updated_at": "2018-01-11",
"start_date": "2017-12-05",
"end_date": "2017-12-07",
"status": "unpaid",
"detail": [
{
"offer_id": 1,
"payout_type": "RPA",
"actions": 100,
"amount": 100,
"comment": null
}
],
"currency": "USD",
"comment": null
},
{
"number": 2,
"supplier_id": "5a37c01cbf0b6b18008b4567",
"created_at": "2018-01-11",
"updated_at": "2018-01-11",
"start_date": "2018-01-11",
"end_date": "2018-01-11",
"status": "unpaid",
"detail": [
{
"offer_id": 1,
"payout_type": "RPA",
"actions": 55,
"amount": 666,
"comment": null
}
],
"currency": "USD",
"comment": "some comment"
}
],
"pagination": {
"per_page": 100,
"total_count": 2,
"page": 1
}
}
Get list of invoices
GET /3.0/admin/advertiser-invoices
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | Integer | Page of entities | |
| limit | Integer | Limit of entities | |
| status | String | Available: paid, unpaid | Status of invoice |
| start_date | String | Start date of period | |
| end_date | String | End date of period |
Invoices view
curl -X GET \
http://api.dev.affise.com/3.0/admin/advertiser-invoice/1 \
-H 'api-key: d4735cd4fbf4ba08729cf3256c358ebefffb6f9d' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-H 'postman-token: 30c120cf-00ba-1689-4171-a927baa21844' \
Response example:
{
"status": 1,
"message": {
"number": 1,
"supplier_id": "5a37c01cbf0b6b18008b4567",
"created_at": "2018-01-11",
"updated_at": "2018-01-11",
"start_date": "2017-12-05",
"end_date": "2017-12-07",
"status": "paid",
"detail": [
{
"offer_id": 1,
"payout_type": "RPA",
"actions": 100,
"amount": 100,
"comment": null
}
],
"currency": "USD",
"comment": null
}
}
Get a invoice
GET /3.0/admin/advertiser-invoice/{number}
Add invoice
curl -X POST \
http://YOUR_API_DOMAIN/3.0/admin/advertiser-invoice \
-H 'api-key: d4735cd4fbf4ba08729cf3256c358ebefffb6f9d' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F status=unpaid \
-F supplier_id=5a37c01cbf0b6b18008b4567 \
-F start_date=2017-12-05 \
-F 'detail[1][offer_id]=1' \
-F 'detail[1][payout_type]=RPA' \
-F 'detail[1][amount]=100' \
-F 'detail[1][actions]=100' \
-F end_date=2017-12-07 \
-F currency=USD \
-F comment=222
Response example:
{
"status": 1,
"message": "Invoice created."
}
Add new invoice
POST /3.0/admin/advertiser-invoice
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| supplier_id | String | REQUIRED Advertiser Id | |
| start_date | String | Start date of invoice period | |
| end_date | String | End date of invoice period | |
| status | String | [paid, unpaid] | Invoice status |
| currency | String | REQUIRED One of the active currencies (RUB, USD, EUR etc) | |
| comment | String | Comment | |
| detail[][offer_id] | integer | Offer id | |
| detail[][payout_type] | string | [RPA,RPS,RPA + RPS,RPC, RPM] | Payout type |
| detail[][actions] | integer | Actions | |
| detail[][amount] | integer | Amount | |
| detail[][comment] | string | Comment for detail |
Edit invoice
curl -X POST \
http://YOUR_API_DOMAIN/3.0/admin/advertiser-invoice/1 \
-H 'api-key: d4735cd4fbf4ba08729cf3256c358ebefffb6f9d' \
-H 'cache-control: no-cache' \
-H 'content-type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW' \
-F status=unpaid
Response example:
{
"status": 1,
"message": "Invoice updated"
}
Change an invoice’s data
POST /3.0/admin/advertiser-invoice/{number}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| supplier_id | String | REQUIRED Advertiser Id | |
| start_date | String | Start date of invoice period | |
| end_date | String | End date of invoice period | |
| status | String | [paid, unpaid] | Invoice status |
| comment | String | Comment | |
| detail[][offer_id] | integer | Offer id | |
| detail[][payout_type] | string | [RPA,RPS,RPA + RPS,RPC, RPM] | Payout type |
| detail[][actions] | integer | Actions | |
| detail[][amount] | integer | Amount | |
| detail[][comment] | string | Comment for detail |
Offer managing (admin methods)
Add offer
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=test&advertiser=573c69a33b7d9b0e638b4576&url=http://example.com&url_preview=http://preview.example.com" http://YOUR_API_DOMAIN/3.0/admin/offer
Response example:
{
"status":1,
"offer":{
"id":936,
"offer_id":"5943f7307e28fe9a1f8b456d",
"advertiser":"573c69a33b7d9b0e638b4576",
"hide_payments":false,
"title":"test",
"macro_url":null,
"url":"http:\/\/affise.com",
"url_preview":"http:\/\/preview.affise.com",
"preview_url":"http:\/\/preview.affise.com",
"domain_url":"affise.tds",
"use_https":false,
"use_http":true,
"description":null,
"countries":[
],
"sources":[
],
"logo":"\/images\/cpa\/logos\/",
"status":"stopped",
"tags":["default"],
"privacy":"public",
"is_top":0,
"payments":[
],
"partner_payments":[
],
"landings":[
],
"strictly_country":0,
"strictly_os":{
"enabled":0
},
"strictly_connection_type": "wifi",
"is_redirect_overcap":false,
"notice_percent_overcap":null,
"hold_period":0,
"categories":[
],
"full_categories":[
],
"cr":0,
"epc":0,
"notes":null,
"allowed_ip":"",
"hash_password":null,
"allow_deeplink":0,
"hide_referer":0,
"start_at":"2017-06-17",
"stop_at":null,
"auto_offer_connect":null,
"required_approval":false,
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"send_emails":false,
"smartlink_categories": ["595e3b5b7e28fede7b8b456d"],
"click_session":"1y",
"external_offer_id":"5a97f4af94b814997c8b456a",
"sub_restrictions": [
{
"sub1": "sub_value1",
"sub2": "sub_value2"
}
],
"strictly_isp": [
"595e3b5b7e28fede7b8b456d"
],
"note_aff":"",
"note_sales":"",
"disallowed_ip":"",
"hide_caps":0,
"caps_status": [
"confirmed"
]
},
"id":936
}
Add new offer
Payment item structure
partners ❋ - Array of partner ID, which include payments (It’s available only for personal payments)
countries - An array of countries in ISO format
country_exclude - Exclude these countries
cities - An array of id cities
devices - The array of devices. Possible values: tablet, desktop, mobile, ipod
os - Array OS Possible values: MeeGo, Windows XP, BlackBerry OS, Ubuntu, Mac OS X, Windows 8, Other, Windows 8.1, Chrome OS, Windows Vista, iOS, Symbian OS, Windows RT, Linux, Android, Windows, Windows 7, Windows Phone
goal - Value targets
total - The amount of payment
revenue - Payment webmaster
currency ❋ - Currency (Code in ECB format)
type ❋ - Type of payment
Possible values: fixed, percent
url - Custom URL tracking
Landing structure
title ❋ - Title
url ❋ - Tracking URL
url_preview ❋ - View URL
type - Type
Possible values: landing, transit
By default: landing
Personal daily limit
partner - webmaster ID
caps - Daily limit
Strictly identify the operating system
os - Values (OS). Possible values: web, wp, ios, android
versions - Versions. When adding OS targeting to the API offer, the version is a equired parameter
Possible values: ios 3, ios 4, ios 5, ios 6, ios 7, ios 8, ios 9, android 2.2, android 2.3, android 4, android 4.1, android 4.2, android 4.3, android 4.4, android 5, android 5.1, android 6, android 7, wp 7, wp 7.5, wp 7.8, wp 8, wp 10
Cap item structure
period - Possible values: day, month, all
type - Possible values: budget, conversions
value - The integer value for the type of conversion and the float value for the budget type.
goals - Array[string]. Either specifies goal value or is empty. Empty field requires “goal_type” values of “all”/“each”.
goal_type - [string]. Values: “all” , “each”, “exact”. “goals” field is mandatory to be specified for “exact” value.
affiliates - Array[integer]. Either specifies affiliate ID or is empty filed. Empty field requires “affiliate_type” values of “all”/“each”.
affiliate_type - [string]. Values: “all” , “each”, “exact”. “affiliates” field is mandatory to be specified for “exact” value.
POST /3.0/admin/offer
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | REQUIRED Title | |
| advertiser | String | REQUIRED Advertiser ID | |
| url | String | REQUIRED Tracking URL | |
| url_preview | String | View URL | |
| trafficback_url | String | Trafficback URL | |
| domain_url | Integer | The domain Id for the tracking URL | |
| description | String | Offer description | |
| description_lang | Array[string] | Offer description on specified language. Example: description_lang[en] = ‘English description’ | |
| stopDate | String | Available: YYYY-MM-DD | Stop date |
| countries | Array[string] | Available: [0] => all, us … | An array of countries in ISO format |
| creativeFiles | Array[string] | Available: image/jpeg, image/png, image/gif, application/zip | An array of creative FILES to upload |
| creativeUrls | Array[string] | An array of URLs to external creative resources | |
| sources | Array[string] | An array of traffic sources The list of available sources of traffic in the section | |
| logo | FormData | Available: image/jpeg, image/pjpeg, image/png, image/gif | logo File |
| status | String | Default: stopped Available: stopped, active, suspended |
Offer status |
| tags | Array[string] | Offer tags | |
| privacy | String | Available: public, protected, private | Privacy level |
| is_top | Integer | Available: 0, 1 | The top offer |
| is_cpi | Integer | Available: 0, 1 | CPI |
| payments | Array[string] | Payments array (See Structure) | |
| partner_payments | Array[string] | An array of personal paymentsy (See Structure) | |
| notice_percent_overcap | Integer | The percentage conversions to achieve the daily limit at which the messages will be sent | |
| landings | Array[string] | An array of landings(See Structure) | |
| strictly_country | Integer | Available: 0, 1 | Strictly identify the country |
| strictly_connection_type | String | Available: wifi,cellular,all | Strictly identify the connection type |
| strictly_os | Array[string] | Strictly identify the operating system(See Structure) | |
| caps | Array[CapStructure] | Caps (See CapStructure) | |
| caps_status | Array[string] | Array of conversion statuses for caps calculation. Available values: “confirmed”, “pending”, “hold”, “not_found”, “declined” | |
| hold_period | Integer | Available: between 0 and 60 | Hold time |
| categories | Array[string] | An array of categories | |
| notes | String | Offer notes | |
| allowed_ip | String | Allowed IP. Example: 127.0.0.1\n127.0.1.1-127.0.2.1 | |
| allow_deeplink | Integer | Available: 0, 1 | Allow diplinks |
| hide_referer | Integer | Available: 0, 1 | Hide referrer |
| redirect_type | String | http302, http302hidden, js, meta | Redirect types: http302 - usual http redirect with code 302. Without referrer passing: http302hidden, meta (meta-tag redirect), js (javascript redirect) |
| start_at | String | Available: YYYY-MM-DD | Date of launch |
| send_emails | Integer | Default: 0 Available: 0, 1 |
Send emails to affiliates by offer changing. |
| is_redirect_overcap | Integer | Default: 0 Available: 0, 1 |
Send traffic to trafficback by daily overcaps. |
| hide_payments | Integer | Default: 0 Available: 0, 1 |
Hide the percentage of contributions to offer for partners if it is the type of Percent payment. |
| click_session | String | Default: 1y | Click Session Lifespan Example: 1y2m3w4d5h6i7s Scales must be one from: y(year), m(month), w(week), d(day), h(hour), i(minute), s(second) |
| sub_account_1 | String | Sub1 list, separated by commas | |
| sub_account_2 | String | Sub2 list, separated by commas | |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Except Sub1 list |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Except Sub2 list |
| smartlink_categories | Array[string] | Collection SmartLink category ID’s | |
| kpi | Array[string] | KPI description on specified language. Example: kpi[en] = ‘English text’ | |
| sub_restrictions | Array[structure] | Sub restriction pair. Example or structure: sub_restrictions[0][sub1] = ‘sub1_val’, sub_restrictions[0][sub2] = ‘sub2_val’, sub_restrictions[1][sub1] = ‘sub2_val’, etc.. | |
| uniqIpOnly | Integer | Default: 0 Available: 0, 1 |
Unique IP only flag |
| strictly_isp | Array[string] | ISP id list | |
| external_offer_id | String | External offer id | |
| note_aff | String | Note for affiliate | |
| note_sales | String | Note for sales | |
| disallowed_ip | String | disallowed ip | |
| hide_caps | Integer | Available: 0, 1 | Hide caps in partner interface |
| search_empty_sub | Integer | Available: 1..8 | Search for an empty sub with this number |
Edit offer
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=test_edit" http://YOUR_API_DOMAIN/3.0/admin/offer/936
Response example:
{
"status":1,
"offer":{
"id":936,
"offer_id":"5943f7307e28fe9a1f8b456d",
"advertiser":"573c69a33b7d9b0e638b4576",
"hide_payments":false,
"title":"test_edit",
"macro_url":null,
"url":"http:\/\/affise.com",
"url_preview":"http:\/\/preview.affise.com",
"preview_url":"http:\/\/preview.affise.com",
"domain_url":"affise.tds",
"use_https":false,
"use_http":true,
"description":null,
"description_lang": {
"ru" : "Описание",
"en" : "Description"
},
"countries":[
],
"sources":[
],
"logo":"\/images\/cpa\/logos\/",
"status":"stopped",
"tags":["default"],
"privacy":"public",
"is_top":0,
"payments":[
],
"partner_payments":[
],
"landings":[
],
"strictly_country":0,
"strictly_os":{
"enabled":0
},
"strictly_connection_type": "wifi",
"is_redirect_overcap":false,
"notice_percent_overcap":null,
"hold_period":0,
"categories":[
],
"full_categories":[
],
"cr":0,
"epc":0,
"notes":null,
"allowed_ip":"",
"hash_password":null,
"allow_deeplink":0,
"hide_referer":0,
"start_at":"2017-06-17",
"stop_at":null,
"auto_offer_connect":null,
"required_approval":false,
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"send_emails":false,
"smartlink_categories": ["595e3b5b7e28fede7b8b456d"],
"click_session":"1y",
"sub_restrictions": [
{
"sub1": "sub_value1",
"sub2": "sub_value2"
}
],
"strictly_isp": [
"595e3b5b7e28fede7b8b456d"
],
"hide_caps":0,
"caps_status": [
"confirmed"
]
},
"id":936
}
Change an offer settings
POST /3.0/admin/offer/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | Title | |
| advertiser | String | Advertiser ID | |
| url | String | Tracking URL | |
| url_preview | String | View URL | |
| trafficback_url | String | Trafficback URL | |
| domain_url | Integer | The domain Id for the tracking URL | |
| description | String | Offer description. | |
| description_lang | Array[string] | Offer description on specified language. Example: description_lang[en] = ‘English description’ | |
| kpi | Array[string] | KPI description on specified language. Example: kpi[en] = ‘English text’ | |
| stopDate | String | Available: YYYY-MM-DD | Stop date |
| countries | Array[string] | Available: [0] => all, us … | An array of countries in ISO format |
| creativeFiles | Array[string] | Available: image/jpeg, image/png, image/gif, application/zip | An array of creative FILES to upload |
| creativeUrls | Array[string] | An array of URLs to external creative resources | |
| sources | Array[string] | An array of traffic sources The list of available sources of traffic in the section | |
| logo | FormData | Available: image/jpeg, image/pjpeg, image/png, image/gif | logo File |
| status | String | Default: stopped Available: stopped, active, suspended |
Offer status |
| tags | Array[string] | Offer tags | |
| privacy | String | Available: public, protected, private | Privacy level |
| is_top | Integer | Available: 0, 1 | The top offer |
| is_cpi | Integer | Available: 0, 1 | CPI |
| payments | Array[string] | Payments array (See Structure) | |
| partner_payments | Array[string] | An array of personal paymentsy (See add offer) | |
| notice_percent_overcap | Integer | The percentage conversions to achieve the daily limit at which the messages will be sent | |
| landings | Array[string] | An array of landings(See Structure) | |
| strictly_country | Integer | Available: 0, 1 | Strictly identify the country |
| strictly_connection_type | String | Available: wifi,cellular,all | Strictly identify the connection type |
| strictly_os | Array[string] | Strictly identify the operating system (See add offer) | |
| caps | Array[CapStructure] | Caps (See CapStructure) | |
| caps_status | Array[string] | Array of conversion statuses for caps calculation. Available values: “confirmed”, “pending”, “hold”, “not_found”, “declined” | |
| hold_period | Integer | Available: between 0 and 60 | Hold time |
| categories | Array[string] | An array of categories | |
| notes | String | Offer notes | |
| allowed_ip | String | Allowed IP. Example: 127.0.0.1\n127.0.1.1-127.0.2.1 | |
| allow_deeplink | Integer | Available: 0, 1 | Allow diplinks |
| hide_referer | Integer | Available: 0, 1 | Hide referrer. Deprecated: use redirect_type |
| redirect_type | String | http302, http302hidden, js, meta | Redirect types: http302 - usual http redirect with code 302. Without referrer passing: http302hidden, meta (meta-tag redirect), js (javascript redirect) |
| start_at | String | Available: YYYY-MM-DD | Date of launch |
| send_emails | Integer | Default: 0 Available: 0, 1 |
Send emails to affiliates by offer changing. |
| is_redirect_overcap | Integer | Default: 0 Available: 0, 1 |
Send traffic to trafficback by daily overcaps. |
| hide_payments | Integer | Default: 0 Available: 0, 1 |
Hide the percentage of contributions to offer for partners if it is the type of Percent payment. |
| click_session | String | Default: 1y | Click Session Lifespan Example: 1y2m3w4d5h6i7s Scales must be one from: y(year), m(month), w(week), d(day), h(hour), i(minute), s(second) |
| sub_account_1 | String | Sub1 list, separated by commas | |
| sub_account_2 | String | Sub2 list, separated by commas | |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Except Sub1 list |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Except Sub2 list |
| smartlink_categories | Array[string] | Collection SmartLink category ID’s | |
| kpi | Array[string] | KPI description on specified language. Example: kpi[en] = ‘English text’ | |
| sub_restrictions | Array[structure] | Sub restriction pair. Example or structure: sub_restrictions[0][sub1] = ‘sub1_val’, sub_restrictions[0][sub2] = ‘sub2_val’, sub_restrictions[1][sub1] = ‘sub2_val’, etc.. | |
| uniqIpOnly | Integer | Default: 0 Available: 0, 1 |
Unique IP only flag |
| strictly_isp | Array[string] | ISP id list | |
| external_offer_id | String | External offer id | |
| hide_caps | Integer | Available: 0, 1 | Hide caps in partner interface |
| search_empty_sub | Integer | Available: 1..8 | Search for an empty sub with this number |
Delete offer
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "offer_id[0]=936" http://YOUR_API_DOMAIN/3.0/admin/offer/delete
Response example:
{
"status":1,
"message":"Offer 936 is removed successfully."
}
Delete the offer
POST /3.0/admin/offer/delete
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Array[integer] | REQUIRED |
Sources
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/offer/sources
Response example:
{
"status":1,
"sources":[
{
"id":"51f531f53b7d9b1e0382f6d9",
"title":"Web sites",
"title_lang":{"ru":"веб сайты","en":"web sites","es":""},
"allowed":0
}
]
}
Get list of sources
GET /3.0/admin/offer/sources
Source add
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title_lang[en]=api-test-en-3&title_lang[ru]=api-test-ru-3&title_lang[es]=api-test-es-2&title_lang[ka]=api-test-ka-2&title_lang[vi]=api-test-vi-3" http://YOUR_API_DOMAIN/3.0/admin/offer/source/
Response example:
{
"status": 1,
"source": {
"title": "api-test-en-3",
"title_lang": {
"en": "api-test-en-3",
"ru": "api-test-ru-3",
"es": "api-test-es-2",
"ka": "api-test-ka-2",
"vi": "api-test-vi-3"
},
"id": "5b7e6d350f0e5a001c7bb4d5"
}
}
Get list of sources
POST /3.0/admin/offer/source
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title_lang | Array[string] | Available: title_lang[ru], title_lang[en], title_lang[es], title_lang[ka], title_lang[vi] | REQUIRED Title different languages |
Source edit
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title_lang[en]=api-test-en-3&title_lang[ru]=api-test-ru-3&title_lang[es]=api-test-es-2&title_lang[ka]=api-test-ka-2&title_lang[vi]=api-test-vi-3" http://YOUR_API_DOMAIN/3.0/admin/offer/source/5b7e6d350f0e5a001c7bb4d5
Response example:
{
"status": 1,
"source": {
"title": "api-test-en-3",
"title_lang": {
"en": "api-test-en-3",
"ru": "api-test-ru-3",
"es": "api-test-es-2",
"ka": "api-test-ka-2",
"vi": "api-test-vi-3"
},
"id": "5b7e6d350f0e5a001c7bb4d5"
}
}
Get list of sources
POST /3.0/admin/offer/source/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title_lang | Array[string] | Available: title_lang[ru], title_lang[en], title_lang[es], title_lang[ka], title_lang[vi] | REQUIRED Title different languages |
Source remove
curl -X DELETE --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/offer/source/5b7e6d350f0e5a001c7bb4d5
Response example:
{
"status": 1,
"source": {
"title": "api-test-en-3",
"title_lang": {
"en": "api-test-en-3",
"ru": "api-test-ru-3",
"es": "api-test-es-2",
"ka": "api-test-ka-2",
"vi": "api-test-vi-3"
},
"id": "5b7e6d350f0e5a001c7bb4d5"
}
}
Get list of sources
DELETE /3.0/admin/offer/source/{ID}
Category add
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=test_category" http://YOUR_API_DOMAIN/3.0/admin/category
Response example:
{
"status":1,
"category":{
"id":"59440f427e28feff5c8b4567",
"title":"test_category"
}
}
Add new category
POST /3.0/admin/category
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | REQUIRED Category title |
Category edit
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "title=test_category2" http://YOUR_API_DOMAIN/3.0/admin/category/59440f427e28feff5c8b4567
Response example:
{
"status":1,
"category":{
"id":"59440f427e28feff5c8b4567",
"title":"test_category2"
}
}
Change a category
POST /3.0/admin/category/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| title | String | REQUIRED Category title |
Enable affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "offer_id=935&pid=610¬ice=0" http://YOUR_API_DOMAIN/3.0/offer/enable-affiliate
Response example:
{
"status":1,
"message":"Request for offer 935 is successfully"
}
Сonnection an affiliate to offer
POST /3.0/offer/enable-affiliate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Mixed: Integer or Array[integer] | REQUIRED | |
| pid | Integer | REQUIRED Affiliate ID | |
| notice | Integer | Default: 1 Available: 0 or 1 |
Send notice to affiliate |
Disable affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "offer_id=935&pid=610¬ice=0" http://YOUR_API_DOMAIN/3.0/offer/disable-affiliate
Response example:
{
"status":1,
"message":"Request for offer 935 is successfully"
}
Disconnect an affiliate from offer
POST /3.0/offer/disable-affiliate
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Mixed: Integer or Array[integer] | REQUIRED | |
| pid | Integer | REQUIRED Affiliate ID | |
| notice | Integer | Default: 1 Available: 0 or 1 |
Send notice to affiliate |
Update offer`s status
Update offers status
POST /3.0/admin/offer/mass-update
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Mixed: Integer or Array[integer] | REQUIRED | |
| status | String | Available: active stopped suspended |
Status |
| privacy | String | Available: public protected private |
Privacy level |
POST /3.0/admin/offer/mass-update HTTP/1.1
Host: api.dev.affise.com
API-Key: d4735cd4fbf4ba08729cf3256c358ebefffb6f9d
Cache-Control: no-cache
Postman-Token: cefe4414-fc5b-1df0-5ef5-f788b8530f8f
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="offer_id[]"
2
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="offer_id[]"
1
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="status"
active
------WebKitFormBoundary7MA4YWxkTrZu0gW--
Response example:
{
"status":1,
"message":"status updated"
}
Disable affiliates
Disconnect all affiliates from private or protected offer
POST /3.0/admin/offer/{id}/disable-affiliates
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| id | Integer | REQUIRED private or protected offer ID |
Response example:
{
"status": 1,
"message": "Affiliates disabled successfully"
}
Disable offers
Disconnect all private or protected offers from affiliate
POST /3.0/admin/affiliate/{id}/disable-offers
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| id | Integer | REQUIRED affiliate ID |
Response example:
{
"status": 1,
"message": "Offers disabled successfully"
}
Affiliate managing (admin methods)
Affiliate list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/partners
Response example:
{
"status":1,
"partners":[
{
"id":1,
"created_at":"2016-11-16 14:13:39",
"updated_at":"2016-11-16 14:13:39",
"email":"1111@qew.com",
"login":"default",
"ref_percent":null,
"name":"10",
"notes":"....",
"manager":null,
"status":"active",
"level":5,
"payment_systems":[
{
"id":10895,
"active":0,
"system":"Webmoney WMR",
"fields":{
"1":"..."
}
},
{
"id":10897,
"active":0,
"system":"Webmoney WMZ",
"fields":{
"1":"..."
}
}
],
"customFields":[
{
"name":"Skype",
"value":"1",
"label":"1",
"id":1
},
{
"name":"....",
"value":"2",
"label":"2",
"id":2
},
{
"name":"...",
"value":"3",
"label":"3",
"id":3
},
{
"name":"....",
"value":"4",
"label":"4",
"id":5
},
{
"name":"...",
"value":"5",
"label":"5",
"id":7
},
{
"name":"...",
"value":"6",
"label":"6",
"id":8
},
{
"name":"...",
"value":"1",
"label":"...",
"id":9
},
{
"name":"...",
"value":[
1
],
"label":{
"1":"..."
},
"id":10
},
{
"name":"...",
"value":[
2
],
"label":{
"2":"..."
},
"id":11
},
{
"name":"...",
"value":"7",
"label":"7",
"id":12
},
{
"name":"....",
"value":"8",
"label":"8",
"id":14
},
{
"name":"...",
"value":"9",
"label":"9",
"id":15
}
],
"balance":{
"USD":{
"balance":3418,
"hold":0,
"available":1050
},
"RUB":{
"balance":0,
"hold":0,
"available":0
}
},
"offersCount":46,
"api_key":"....",
"tags":[
]
}
],
"pagination":{
"per_page":1,
"total_count":9253,
"page":1,
"next_page":2
}
}
Get list of a partners
GET /3.0/admin/partners
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| with_balance | Integer | Available: 1 | Show partners with balance |
| limit | Integer | Limit of entities | |
| page | Integer | Page of entities |
New affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "email=affiliate@affise.com&password=affiliate" http://YOUR_API_DOMAIN/3.0/admin/partner
Response example:
{
"status":1,
"partner":{
"id":10117,
"created_at":"2018-09-27 10:36:59",
"updated_at":null,
"email":"affiliate@affise.com",
"login":null,
"ref_percent":null,
"name":null,
"notes":"",
"manager":null,
"status":"",
"level":0,
"payment_systems":[
],
"customFields":[
],
"balance":{
"USD":{
"balance":0,
"hold":0,
"available":0
},
"RUB":{
"balance":0,
"hold":0,
"available":0
}
},
"offersCount":0,
"api_key":"b2fde3bde361d731138472daad283527c1602718"
},
"id":10117
}
Add new partner
Payment item structure
system_id - Integer ID of partners systems
currency - String the currency code.
fields - An array of Advanced fields. For example {‘Integer key’: ‘String value’} where the key is ID from /3.0/admin/payment_systems and value it’s your value of this field.
POST /3.0/admin/partner
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| String | REQUIRED Partners e-mail | ||
| password | String | REQUIRED Partners password | |
| login | String | Partners name | |
| ref_percent | String | Percentage of referral program | |
| notes | String | Notes | |
| status | String | Available: ‘not active’, ‘active’, ‘banned’, ‘on moderation’ | Partners status |
| level | Integer | Partners level | |
| manager_id | String | Manager id | |
| payment_systems | Array[string] | An array of payments (See Structure and /admin/payment_systems) | |
| custom_fields | Array[string] | An array of custom fields (See /admin/custom_fields) | |
| ref | Integer | Referral partner |
Edit affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "password=affiliate2&status=on moderation" http://YOUR_API_DOMAIN/3.0/admin/partner/10117
Response example:
{
"status":1,
"partner":{
"id":10117,
"created_at":"2018-09-27 10:36:59",
"updated_at":"2018-09-28 10:36:59",
"email":"affiliate@affise.com",
"login":null,
"ref_percent":null,
"name":null,
"notes":"",
"manager":null,
"status":"on moderation",
"level":0,
"payment_systems":[
],
"customFields":[
],
"balance":{
"USD":{
"balance":0,
"hold":0,
"available":0
},
"RUB":{
"balance":0,
"hold":0,
"available":0
}
},
"offersCount":0,
"api_key":"b2fde3bde361d731138472daad283527c1602718"
},
"id":10117
}
Edit a partner
POST /3.0/admin/partner/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| password | String | Partners password | |
| login | String | Partners name | |
| ref_percent | String | Percentage of referral program | |
| notes | String | Notes | |
| status | String | Available: “, ‘not active’, ‘active’, ‘banned’, ‘on moderation’ | Partners status |
| level | Integer | Partners level | |
| manager_id | String | Manager id | |
| payment_systems | Array[string] | An array of payments (See the add affiliate method and /admin/payment_systems) | |
| custom_fields | Array[string] | An array of custom fields (See /admin/custom_fields) | |
| ref | Integer | Referral partner |
Change affiliate password
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/partner/password/10117
Response example:
{
"status":1,
"partner":{
"id":10117,
"password":"5947c33371"
}
}
Change a partner’s password
POST /3.0/admin/partner/password/{ID}
Add partner postback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "url=http://affise.com&status=by_creating&offer_id=906&pid=610" http://YOUR_API_DOMAIN/3.0/partner/postback
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"by_creating",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Add a partner’s postback
POST /3.0/partner/postback
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer_id | Integer | Offer ID (missed parameter means creation of global postback) | |
| url | String | REQUIRED Example: http://affise.com | |
| status | String | Available: by_creating, confirmed, pending, declined, hold, not_found | Postback status |
| goal | String | Postback goal | |
| pid | Integer | Affiliate ID |
Edit partner postback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "url=http://affise.com&status=confirmed&offer_id=906&pid=610" http://YOUR_API_DOMAIN/3.0/partner/postback/960
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"confirmed",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Edit a partner’s postback
POST /3.0/partner/postback/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| url | String | REQUIRED Example: http://affise.com | |
| status | String | Available: by_creating, confirmed, pending, declined, hold, not_found | Postback status |
| goal | String | Postback goal | |
| pid | Integer | Affiliate ID |
Delete partner postback
curl -X DELETE --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/postback/960/remove
Response example:
{
"status":1,
"postback":{
"id":960,
"url":"http:\/\/affise.com",
"status":"confirmed",
"goal":null,
"created":"2017-06-20 02:17:58",
"forced":"0"
}
}
Delete a partner’s postback
DELETE /3.0/partner/postback/{ID}/remove
Affiliate postbacks list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/postbacks
Response example:
{
"status":1,
"postbacks":[
{
"id":8,
"url":"http://...",
"offer_id":null,
"status":"pending",
"goal":"",
"created":"2018-01-30 18:31:52",
"forced":"0"
},
{
"id":22,
"url":"http://...",
"offer_id":"17",
"status":null,
"goal":"",
"created":"2018-05-14 12:39:51",
"forced":"0"
},
{
"id":23,
"url":"http://...",
"offer_id":"17",
"status":"confirmed",
"goal":"1",
"created":"2018-05-14 12:41:00",
"forced":"0"
}
],
"pagination":{
"per_page":100,
"total_count":4,
"page":1
}
}
Get a list of partner postbacks
GET /3.0/admin/postbacks
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| partner_id | Integer | REQUIRED | |
| limit | Integer | Limit of entities | |
| page | Integer | Page of entities |
User managing (admin methods)
Users list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/users
Response example:
{
"status":1,
"users":[
{
"id":"55c1fa2dd227652d222263f2",
"first_name":"...",
"last_name":"...",
"email":"...",
"skype":null,
"roles":[
"ROLE_MANAGER_SALES"
],
"api_key":null,
"created_at":null
}
],
"pagination":{
"per_page":100,
"total_count":18,
"page":1
}
}
Get a list of users
GET /3.0/admin/users
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | Integer | Page of entities | |
| limit | Integer | Limit of entities |
Add user
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "email=user@affise.com&password=12345&last_name=Affise&first_name=User" http://YOUR_API_DOMAIN/3.0/admin/user
Response example:
{
"status":1,
"user":{
"id":"594927bd7e28fe1c4a8b4569",
"first_name":"User",
"last_name":"Affise",
"email":"user@affise.com",
"skype":null,
"roles":[
],
"api_key":null,
"created_at":null,
"password":"12345"
}
}
Add a new user
Roles list
ROLE_ADMIN - Administrator
ROLE_MANAGER_AFFILIATE - Affiliate manager
ROLE_MANAGER_SALES - Sales manager
ROLE_MANAGER_AFFILIATE - Affiliate manager
ROLE_MANAGER_SALES - Sales manager
ROLE_SECTION_OFFER - Offer section
ROLE_SECTION_SUPPLIER - Supplier section
ROLE_SECTION_STATS - Satistics section
ROLE_SECTION_DASHBOARD - Dashboard section
ROLE_SECTION_NEWS - News section
ROLE_SECTION_CATEGORY - Category section
ROLE_SECTION_PARTNER - Affiliate section
ROLE_SECTION_PAYMENT - Billing section
ROLE_SECTION_TICKET - Ticket section
ROLE_MANAGER_SALES - Sales manager
ROLE_SECTION_OFFER - Offer section
ROLE_SECTION_SUPPLIER - Supplier section
ROLE_SECTION_DASHBOARD - Dashboard section
ROLE_SECTION_NEWS - News section
ROLE_SECTION_CATEGORY - Category section
ROLE_SECTION_PAYMENT - Billing section
ROLE_SECTION_TICKET - Ticket section
ROLE_SECTION_STATS_COMMON - Daily stats
ROLE_SECTION_STATS_CONVERSION - Conversions
ROLE_SECTION_STATS_SUPPLIER - Suppliers
ROLE_SECTION_STATS_OFFER - Offers
ROLE_SECTION_STATS_COUNTRY - Countries
ROLE_SECTION_STATS_CITY - Cities
ROLE_SECTION_STATS_OS - OS
ROLE_SECTION_STATS_GOAL - Goals
ROLE_SECTION_STATS_DEVICE - Devices
ROLE_SECTION_STATS_PARTNER_POSTBACK - User postbacks
ROLE_SECTION_STATS_SERVER_POSTBACK - Server postbacks
ROLE_SECTION_DASHBOARD - Dashboard section
ROLE_SECTION_OFFER - Offer section
ROLE_SECTION_SUPPLIER - Supplier section
ROLE_SECTION_PARTNER - Affiliate section
ROLE_SECTION_STATS - Satistics section
ROLE_SECTION_STATS_COMMON - Daily stats
ROLE_SECTION_STATS_CONVERSION - Conversions
ROLE_SECTION_STATS_SUPPLIER - Suppliers
ROLE_SECTION_STATS_OFFER - Offers
ROLE_SECTION_STATS_PARTNER - Partners
ROLE_SECTION_STATS_COUNTRY - Countries
ROLE_SECTION_STATS_CITY - Cities
ROLE_SECTION_STATS_OS - OS
ROLE_SECTION_STATS_GOAL - Goals
ROLE_SECTION_STATS_DEVICE - Devices
ROLE_SECTION_STATS_LIMITS - Limits statistics
ROLE_SECTION_STATS_PARTNER_POSTBACK - User postbacks
ROLE_SECTION_STATS_SERVER_POSTBACK - Server postbacks
ROLE_SECTION_NEWS - News section
ROLE_SECTION_CATEGORY - Category section
ROLE_SECTION_PAYMENT - Billing section
ROLE_SECTION_TICKET - Ticket section
POST /3.0/admin/user
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| String | REQUIRED Email | ||
| password | String | Available: at least 5 characters | REQUIRED Password |
| first_name | String | REQUIRED Name | |
| last_name | String | REQUIRED Last name | |
| roles | Array[string] | REQUIRED Array off allowed roles. See roles | |
| skype | String | Skype | |
| work_hours | String | Working time |
Edit user
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "email=user2@affise.com&password=12345&last_name=Affise2&first_name=User2" http://YOUR_API_DOMAIN/3.0/admin/user/594927bd7e28fe1c4a8b4569
Response example:
{
"status":1,
"user":{
"id":"594927bd7e28fe1c4a8b4569",
"first_name":"User2",
"last_name":"Affise2",
"email":"user2@affise.com",
"skype":null,
"roles":[
],
"api_key":null,
"created_at":null,
"password":"12345"
}
}
Change the user
POST /3.0/admin/user/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| String | |||
| password | String | Available: at least 5 characters | Password |
| first_name | String | Name | |
| last_name | String | Last name | |
| roles | Array[string] | Array off allowed roles. See add user | |
| skype | String | Skype | |
| work_hours | String | Working time |
Change user api key
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "" http://YOUR_API_DOMAIN/3.0/admin/user/api_key/594927bd7e28fe1c4a8b4569
Response example:
{
"status":1,
"user":{
"id":"594927bd7e28fe1c4a8b4569",
"api_key":"c740955e768795098c8b91ef40ec008526f3f884"
}
}
Change user api key
POST /3.0/admin/user/api_key/{ID}
Conversions managing
Edit conversion
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "ids[0]=59359e1d7e28feb7568b456a&status=confirmed" http://YOUR_API_DOMAIN/3.0/admin/conversion/edit
Response example:
{
"status":1,
"data":{
"ids":[
"59359e1d7e28feb7568b456a"
],
"status":"confirmed",
"currency":null,
"payouts":null,
"revenue":null
},
"message":"Conversion changes will take a few minutes"
}
Edit a conversion
POST /3.0/admin/conversion/edit
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| ids | Array[string] | REQUIRED | |
| status | String | Available: confirmed, pending, declined, not_found, hold | |
| currency | String | Example: usd | |
| payouts | Integer | ||
| revenue | Integer | ||
| comment | String | Text a comment |
Import single conversion
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "offer=1000&pid=500" http://YOUR_API_DOMAIN/3.0/admin/conversion/import
Response example:
{
"status": 1,
"data": {
"list": [
{
"offer": 1000,
"pid": 500,
"action_id": null,
"goal": null,
"ip": null,
"ua": null,
"sum": null
}
]
},
"message": "Conversion import will take a few minutes"
}
Import a single conversion
POST /3.0/admin/conversion/import
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| offer | Integer | REQUIRED Offer id | |
| pid | Integer | REQUIRED Partner id | |
| action_id | String | publisher conversion id | |
| goal | Integer | goal number | |
| ip | String | visitor ip | |
| ua | String | visitor user-agent | |
| sum | Integer | payouts amount for conversion (for percent payment type only) | |
| status | String | Available: confirmed, pending, declined, not_found, hold, pending_cap |
Import multiple conversions
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "list[0][offer]=1000&list[0][pid]=500" http://YOUR_API_DOMAIN/3.0/admin/conversions/import
Response example:
{
"status": 1,
"data": {
"list": [
{
"offer": 1000,
"pid": 500,
"action_id": null,
"goal": null,
"ip": null,
"ua": null,
"sum": null
}
]
},
"message": "Conversion import will take a few minutes"
}
Import multiple conversions
POST /3.0/admin/conversions/import
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| list[0][offer] | Integer | REQUIRED Offer id | |
| list[0][pid] | Integer | REQUIRED Partner id | |
| list[0][action_id] | String | publisher conversion id | |
| list[0][goal] | Integer | goal number | |
| list[0][ip] | String | visitor ip | |
| list[0][ua] | String | visitor user-agent | |
| list[0][sum] | Integer | payouts amount for conversion (for percent payment type only) | |
| list[0][status] | String | Available: confirmed, pending, declined, not_found, hold, pending_cap |
Other managing (admin methods)
City list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/cities?locale=en&country=ru&page=1
Response example:
{
"status":1,
"cities":[
{
"id":4046230,
"name":"Cherokee",
"time_zone":"America\/Chicago",
"country_code":"US"
},
{
"id":4046252,
"name":"Cost",
"time_zone":"America\/Chicago",
"country_code":"US"
}
],
"pagination":{
"per_page":100,
"total_count":25477,
"page":1,
"next_page":2
}
}
Get city list
GET /3.0/cities
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| locale | String | Default: en | Locale for name of city |
| page | integer | Default: 1 | Page of stat entities |
| country | String | REQUIRED Country code. Example : US |
Currency list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/currency
Response example:
{
"status":1,
"quotes":{
"RUB":59.312599,
"USD":1,
"AED":3.672497,
"AFN":66.669998,
"ALL":125.800003,
"AMD":485.299988,
"ANG":1.769851,
"AOA":165.080994
}
}
Get list of currency
GET /3.0/admin/currency
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| get_only_active | integer | Default: 0 Available: 1 |
Ignore inactive currencies |
Payment systems list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/payment_systems
Response example:
{
"status":1,
"payment_systems":[
{
"id":2,
"lang_label":"Wire transfer",
"fields":[
{
"id":1,
"lang_label":"IBAN\/Account Number",
"required":true
},
{
"id":2,
"lang_label":"Swift\/BIC-Code",
"required":true
},
{
"id":3,
"lang_label":"Bank name",
"required":true
},
{
"id":4,
"lang_label":"Bank address",
"required":true
}
],
"currency":null
},
{
"id":3,
"lang_label":"Webmoney WMZ",
"fields":[
{
"id":1,
"lang_label":"WMZ",
"required":true
}
],
"currency":"AED"
}
]
}
Get list of payment systems
GET /3.0/admin/payment_systems
Custom fields list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/custom_fields
Response example:
{
"status":1,
"fields":[
{
"id":1,
"name":"Skype",
"required":false,
"field_type":"text",
"field_values":null
}
]
}
Get list of signup settings
GET /3.0/admin/custom_fields
Domains list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/domains
Response example:
{
"status":1,
"domains":{
"1":{
"id":1,
"url":"affise.com"
}
}
}
Get domains
GET /3.0/admin/domains
Ticket list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/tickets
Response example:
{
"status":1,
"tickets":[
{
"id":"17340",
"status":"open",
"type":"common",
"title":"...",
"description":"...",
"partner":{
"id":9310,
"updated_at":"2016-03-01 14:07:29",
"email":"...@...",
"login":"...@...",
"ref_percent":null,
"name":"",
"notes":"...",
"manager":null,
"status":"active",
"level":0,
"payment_systems":[
{
"id":10811,
"active":0,
"system":"Webmoney WMZ",
"fields":{
"1":"...."
}
},
{
"id":10812,
"active":0,
"system":"Webmoney WMR",
"fields":{
"1":"...."
}
}
],
"customFields":[
{
"name":"Skype",
"value":"...",
"label":"...",
"id":1
}
],
"balance":{
"USD":{
"balance":14,
"hold":0,
"available":14
}
},
"offersCount":3,
"api_key":"5099412c192828adfe79892d25e5e4a41ffb"
},
"offer":{
"id":718,
"offer_id":"563785d13b7d9bc31b8b4585",
"title":"...",
"preview_url":"https:\/\/affise.com\/",
"description":"...",
"cr":0.63,
"epc":0.03,
"logo":"http:\/\/affise.admin\/images\/cpa\/logos\/292223717.png",
"stop_at":null,
"sources":[
{
"id":"51f531f53b7d9b1e0382f6d9",
"title":"Web sites",
"allowed":1
},
],
"categories":[
"..."
],
"full_categories":[
{
"id":"5368afb23b7d9b4d5d505342",
"title":"..."
}
],
"countries":[
"us"
],
"payments":[
{
"countries":[
"US"
],
"cities":[
],
"country_exclude":false,
"title":"",
"goal":1,
"revenue":7,
"currency":null,
"type":"fixed",
"devices":[
],
"os":[
]
}
],
"goals":{
"1":""
},
"required_approval":true,
"landings":[
{
"id":1446479313,
"title":"...",
"url":"http:\/\/affise.com\/landingpages\/1811\/index.php\u0026click_id={clickid}",
"url_preview":"http:\/\/affise.com\/landingpages\/1880\/index.php",
"type":"landing"
}
],
"is_cpi":false,
"creatives":[
],
"creatives_zip":null,
"links":[
],
"macro_url":null,
"link":null,
"use_https":false,
"use_http":true,
"hold_period":21,
"click_session":null
},
"created":"2016-09-23 19:31:20",
"updated":"1970-01-01 03:00:00"
}
],
"pagination":{
"per_page":100,
"total_count":0,
"page":1
}
}
Get list of tickets for connection to offers
GET /3.0/admin/tickets
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | integer | Default: 1 | Page of stat entities |
| limit | integer | Default: 100 | Limit of entities |
| status | string | Available: open, closed |
Approve or reject ticket
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "do=approve" http://YOUR_API_DOMAIN/3.0/admin/ticket/17340/offer
Response example:
{
"status":1,
"message":"Request is successfully"
}
Approve or reject ticket for connect affiliate to offer
POST /3.0/admin/ticket/{ID}/offer
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| do | String | Available: approve, reject | What need to do with a ticket |
Pixel list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/pixels/610
Response example:
{
"status":1,
"pixel":{
"1":{
"id":1,
"name":"...",
"code":"\u003Cscript\u003Ealert(\u0027123\u0027);\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-19 22:49:07",
"updated_at":"2017-06-19 22:49:07"
}
}
}
Get list of a partner’s pixels
GET /3.0/partner/pixels/{ID}
Pixel add
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "pid=610&offer_id=906&name=test&code=<script>test</script>&code_type=javascript" http://YOUR_API_DOMAIN/3.0/partner/pixel
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test",
"code":"\u003Cscript\u003Etest\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Add a partner’s pixel
POST /3.0/partner/pixel
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| pid | Integer | REQUIRED affiliate’s ID | |
| offer_id | Integer | REQUIRED Offer’s ID | |
| name | String | REQUIRED Name | |
| code | String | Available: <script>…code…</scipt>, <img …>, <iframe src=“…”></iframe> | REQUIRED Code |
| code_type | String | Available: javascript, iframe, image | REQUIRED Code type |
| is_active | Integer | Available: 0, 1 | Active or not |
| moderation_status | Integer | Available: | Moderation status |
Pixel edit
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "pid=610&offer_id=906&name=test2&code=<script>test2</script>&code_type=javascript" http://YOUR_API_DOMAIN/3.0/partner/pixel/2
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test2",
"code":"\u003Cscript\u003Etest2\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Edit a partner’s pixel
POST /3.0/partner/pixel/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | Name | |
| code | String | Available: <script>…code…</scipt>, <img …>, <iframe src=“…”></iframe> | Code |
| code_type | String | Available: javascript, iframe, image | Code type |
| is_active | Integer | Available: 0, 1 | Active or not |
| moderation_status | Integer | Available: | Moderation status |
Pixel remove
curl -X DELETE --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/pixel/2/remove
Response example:
{
"status":1,
"pixel":{
"id":2,
"name":"test2",
"code":"\u003Cscript\u003Etest2\u003C\/script\u003E",
"code_type":"javascript",
"offer_id":"906",
"pid":"610",
"is_active":"0",
"moderation_status":"0",
"created_at":"2017-06-21 03:34:51",
"updated_at":"2017-06-21 03:34:51"
}
}
Delete a partner’s pixel
DELETE /3.0/partner/pixel/{ID}/remove
SmartLink categories
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/smartlink/categories
Response example:
{
"status":1,
"data":[
{
"_id":"595e3b547e28fede7b8b456c",
"name":"test1",
"domain":"myDomen.com",
"domain_id": null,
"use_https":false,
"description":null,
"count_offer":1,
"created_at":"2017-07-06 13:29:56",
"updated_at":"2017-07-06 13:29:56"
}
]
}
SmartLink categories list
GET /3.0/admin/smartlink/categories
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| id | Array[string] | SmartLink categories ID collections |
SmartLink category
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "name=test&domain=myDomen.com&use_https=0&description=test" http://YOUR_API_DOMAIN/3.0/admin/smartlink/category
Response example:
{
"status":1,
"data":{
"_id":"595fd4877e28fee8428b459f",
"name":"test",
"domain":"myDomen.com",
"domain_id": null,
"use_https":"0",
"description":"test",
"count_offer":0,
"created_at":"2017-07-07 18:35:51",
"updated_at":"2017-07-07 18:35:51"
}
}
Add new the SmartLink category
POST /3.0/admin/smartlink/category
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | REQUIRED Name of category | |
| domain_id | Integer | If you stay it as empty will set the default TDS domain. The domain ID from your domain list. | |
| description | String | Description of the category |
Edit a SmartLink category
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "name=test123&domain=myDomen.com&use_https=0&description=test" http://YOUR_API_DOMAIN/3.0/admin/smartlink/category/595fd4877e28fee8428b459f
Response example:
{
"status":1,
"data":{
"_id":"595fd4877e28fee8428b459f",
"name":"test123",
"domain":"myDomen.com",
"domain_id": null,
"use_https":"0",
"description":"test",
"count_offer":0,
"created_at":"2017-07-07 18:35:51",
"updated_at":"2017-07-07 18:35:51"
}
}
Edit a SmartLink category
POST /3.0/admin/smartlink/category/{ID}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | Name of category | |
| domain_id | Integer | If you stay it as empty will set the default TDS domain. The domain ID from your domain list. | |
| description | String | Description of the category |
Remove a SmartLink category
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "" http://YOUR_API_DOMAIN/3.0/admin/smartlink/category/595fd4877e28fee8428b459f/remove
Response example:
{
"status":1,
"data":{
"_id":"595fd4877e28fee8428b459f",
"name":"test123",
"domain":"myDomen.com",
"domain_id": null,
"use_https":"0",
"description":"test",
"count_offer":0,
"created_at":"2017-07-07 18:35:51",
"updated_at":"2017-07-07 18:35:51"
}
}
Remove a SmartLink category
POST /3.0/admin/smartlink/category/{ID}/remove
# Other managing
ISP list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/isp?q=some_query&limit=10
Response example:
{
"status": 1,
"isp": [
{
"id": "58a3064a63c96696388b4567",
"name": "Herbalife (China) Health Products",
"country": "CN"
},
{
"id": "58a3072b63c96696388b6277",
"name": "Herbalife International Of America",
"country": "US"
},
{
"id": "58a3073363c96696388b6380",
"name": "Burkhalter Rudolf trading as Herbert Ospelt Anstal",
"country": "LI"
},
{
"id": "58a3078663c96696388b6e53",
"name": "Herbert Rodrigues Soares",
"country": "BR"
}
],
"pagination": {
"per_page": 4,
"total_count": 9,
"page": 1,
"next_page": 2
}
}
Get ISP list
GET /3.0/isp
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| q | String | Search query | |
| page | integer | Default: 1 | Page of isp entities |
| limit | integer | Limit per page |