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” |
Conversion
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/conversionsbyid?id={id}"
Response example:
{
"conversion": {
"id": "5bd00d73901fcf20008b4574",
"action_id": "5bd00c641d580e000162cf94",
"status": 1,
"conversion_id": "5bd00d73901fcf20008b4574",
"cbid": "5bd00c641d580e000162cf94",
"currency": "USD",
"offer": {
"id": 7,
"title": "Test Offer",
"offer_id": "5b59b752f44d940011105103",
"url": "http://site.com"
},
"offer_id": 7,
"goal": "",
"hold_date_expire": null,
"ip": "172.18.0.1",
"country": "",
"country_name": "",
"district": null,
"city": "Undefined",
"city_id": 0,
"isp_code": "",
"ua": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36",
"browser": "Unknown Unknown",
"os": "Linux Unknown",
"device": "desktop",
"device_type": "desktop",
"sub1": null,
"sub2": null,
"sub3": null,
"sub4": null,
"sub5": null,
"sub6": null,
"sub7": null,
"sub8": null,
"custom_field_1": null,
"custom_field_2": null,
"custom_field_3": null,
"custom_field_4": null,
"custom_field_5": null,
"custom_field_6": null,
"custom_field_7": null,
"comment": null,
"created_at": "2018-10-22 09:13:07",
"click_time": "2018-10-22 09:08:36",
"referrer": null,
"landing_id": null,
"prelanding_id": null,
"createdAt": "2018-10-22 09:13:07",
"updatedAt": "2018-10-22 09:13:07",
"currency_id": null,
"price": null,
"clickid": "5bd00c641d580e000162cf94",
"partner": {
"id": 2,
"email": "emailtest@yahoo.com",
"login": "Yvette Michael",
"name": "Yvette Michael",
"manager": null
},
"supplier_id": "5b5f415035752723008b456a",
"partner_id": 2,
"goal_value": "1",
"sum": 0,
"revenue": 3,
"payouts": 3,
"earnings": 3,
"advertiser": {
"id": "5b5f415035752723008b456a",
"title": "Text supplier 2"
},
"payment_type": "fixed",
"payment_status": "opened",
"is_paid": "1",
"charge": 6,
"earning": 3,
"click_id": "5bd00c641d580e000162cf94"
},
"status": 1
}
Get conversions
GET /3.0/stats/conversionsbyid?id={id}
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” | |
| advertisers | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By accounts managers
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyaccountmanager?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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By browser version
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbybrowsersversion?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_version":"70"
},
"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 version
GET /3.0/stats/getbybrowsersversion
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By landing
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbylanding?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&filter[offer]=1&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"landing":"1543238303"
},
"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
}
},
"ratio": "",
"epc": 0,
"landings_info": {
"1543238303": {
"url": "http://test-url.com",
"preview_url": "http://test-preview-url.com",
"title": "333"
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by landing
GET /3.0/stats/getbylanding
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By prelanding
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyprelanding?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&filter[offer]=1&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"prelanding": 1543243821
},
"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
}
},
"ratio": "",
"epc": 0,
"landings_info": {
"1543243821": {
"url": "http://test-url.com",
"preview_url": "http://test-preview-url.com",
"title": "333"
}
}
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by prelanding
GET /3.0/stats/getbyprelanding
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By mobile carrier
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbymobilecarrier?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"isp": ""
},
"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
}
},
"ratio": "",
"epc": 0
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by mobile carrier
GET /3.0/stats/getbymobilecarrier
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By connection type
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getbyconnectiontype?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&locale=en&limit=1
Response example:
{
"status":1,
"stats":[
{
"slice":{
"conn_type": ""
},
"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
}
},
"ratio": "",
"epc": 0
}
],
"pagination":{
"per_page":1,
"total_count":1,
"page":1
}
}
Get statistics by connection type
GET /3.0/stats/getbyconnectiontype
| 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | 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[sub6] | Mixed: String or Array[string] | Sub 6 | |
| filter[sub7] | Mixed: String or Array[string] | Sub 7 | |
| filter[sub8] | Mixed: String or Array[string] | Sub 8 | |
| filter[device] | Mixed: String or Array[string] | Device |
By referral payments
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/stats/getreferralpayments?filter[date_from]=2017-05-31&filter[date_to]=2017-05-31&orderType=asc&limit=1
Response example:
{
"status":1,
"ref_payments":[
{
"pid":"2",
"ref":"3",
"status":"0",
"is_paid":"0",
"currency":"USD",
"count":"4",
"max_created_at":"2016-03-19 16:25:22",
"date_registration_partner":"2016-10-30 10:22:12",
"sum_revenue":"0.20000"
}
],
"pagination":{
"per_page":100,
"total_count":1,
"page":1
}
}
Get statistics by referral payments
GET /3.0/stats/getreferralpayments
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| date_from | String | Available: DD-MM-YYYY | REQUIRED Date from |
| date_to | String | Available: DD-MM-YYYY | REQUIRED Date to |
| pid | Integer | Partner ID | |
| ref | Integer | Referral partner ID | |
| is_paid | Integer | Available: 0 => payouts, 1 => paid, 2 => pending | Status |
| status | Integer | Available: 0 => no, 1 => yes | Active |
| page | Integer | Default: 1 | Page of stat entities |
| limit | Integer | Default: 100 | Limit of stat entities |
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. | |
| supplier | Array[string] | Advertiser 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": 1,
"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[integer] | Offers ID’s | |
| partner | Array[integer] | Partners ID’s. | |
| goal | String | Goal | |
| status | integer | Status | |
| http_code | integer | 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 (value) |
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 (value) |
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
SmartLink categories
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/partner/smartlink/categories
Response example:
{
"status":1,
"data":[
{
"_id":"595e3b547e28fede7b8b456c",
"name":"test1",
"domain":"myDomen.com",
"use_https":false,
"description":null,
"created_at":"2017-07-06 13:29:56",
}
]
}
SmartLink categories list
GET /3.0/partner/smartlink/categories
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| id | Array[string] | SmartLink categories ID collections |
SmartLink offer count
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "" http://YOUR_API_DOMAIN/3.0/partner/smartlink/category/595fd4877e28fee8428b459f/offers-count
Response example:
{
"status":1,
"data":{
"count":2
}
}
Add new SmartLink category
GET /3.0/partner/smartlink/category/{id}/offers-count
Offers
Offers list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/offers
Response example:
{
"status":1,
"offers":[
{
"id": 331,
"offer_id": "5bdffa7339f65625008b4568",
"advertiser": "5bc9d7c16d73e41c008b4567",
"external_offer_id": "",
"hide_payments": false,
"title": "blabla",
"macro_url": "",
"url": "",
"cross_postback_url":"http:\/\/test-url.com",
"url_preview": "",
"preview_url": "",
"domain_url": "",
"trafficback_url": "",
"use_https": true,
"use_http": true,
"description_lang": {
"ru" : "Описание",
"en" : "Description"
},
"countries": [
"us"
],
"sources": [
{
"id": "51f531f53b7d9b1e0382f6d9",
"title": "Web sites",
"allowed": 1
}
],
"logo": "http:\/\/affise.admin\/images\/cpa\/logos\/787450449.jpeg",
"logo_source": "",
"status": "active",
"tags": [],
"privacy": "public",
"is_top": 0,
"payments": [
{
"countries": [
"kz"
],
"cities": [
{
"country_code": "KZ",
"id": 563497,
"name": "Maksut",
"region_code": "Qostanay Oblysy"
}
],
"devices": [],
"os": [],
"goal": "1",
"revenue": 500,
"currency": "usd",
"title": "goal1",
"type": "fixed",
"country_exclude": false,
"total": 1000,
"with_regions": false,
"goal_alias": "",
"url": null
}
],
"partner_payments": [],
"total_cap": 0,
"total_cap_start_date": "",
"daily_cap": 0,
"daily_cap_partner": 0,
"daily_cap_partners": [],
"landings": [
{
"id": 1,
"title": "...",
"url": "http://affise.com/l1/",
"url_preview": "http://affise.com/l1/",
"type": "landing"
}
],
"strictly_country": 0,
"strictly_os": [],
"strictly_brands": [],
"strictly_connection_type": null,
"restriction_isp": null,
"is_redirect_overcap": false,
"notice_percent_overcap": 0,
"hold_period": 0,
"categories": [
"...",
"..."
],
"full_categories": [
{
"id": "5368afb23b7d9b4d5d505342",
"title": "..."
},
{
"id": "55b204663b7d9b460b8b45b2",
"title": "..."
}
],
"cr": 0,
"epc": 0,
"notes": "",
"allowed_ip": "",
"disallowed_ip": "",
"hash_password": "",
"allow_deeplink": false,
"hide_referer": false,
"start_at": "2018-11-06 12:35:00",
"stop_at": "",
"auto_offer_connect": 0,
"required_approval": false,
"is_cpi": false,
"creatives": [],
"creatives_zip": null,
"created_at": "2018-11-05 11:08:19",
"sub_accounts": {
"1": {
"value": "",
"except": false
},
"2": {
"value": "",
"except": false
}
},
"kpi": {
"ru": "",
"en": "",
"es": "",
"ka": "",
"vi": ""
},
"strictly_isp": [],
"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": []
}
],
"updated_at": "2019-02-08 10:03:38",
"allow_impressions": false,
"smartlink_categories": []
}
],
"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) | |
| updated_at | String | Get offers that have been updated from this date (format YYYY-MM-DD) |
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",
"external_offer_id": false,
"hide_payments": false,
"title": "",
"macro_url": "",
"url": "http://.../desktop/1/?w=32&t=...&a1={clickid}&a5={pid}",
"cross_postback_url":"http:\/\/test-url.com",
"url_preview": "http://.../desktop/1/",
"preview_url": "http://.../desktop/1/",
"domain_url": "affise.tds",
"use_https": true,
"use_http": true,
"description_lang": {
"ru": "",
"en": "",
"es": "",
"ka": "",
"vi": ""
},
"countries": [],
"sources": [
"51f531f53b7d9b1e0382f6d9",
"51f532053b7d9b340eea741a",
"51f532103b7d9b340e325f1c",
"51f5322d3b7d9b340eabb872",
"51f532393b7d9b5e030908a0",
"51f5325e3b7d9b340e8a2b79",
"51f532713b7d9b5e03b24520",
"51f532873b7d9b5e03e88a74",
"5432ffe43b7d9b615f4f7f2a",
"5432fff93b7d9b615fab559d"
],
"logo": "/images/cpa/logos/4228614618.png",
"logo_source": null,
"status": "active",
"tags": [],
"privacy": "public",
"is_top": 0,
"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
]
}
],
"total_cap": 0,
"total_cap_start_date": null,
"daily_cap": 0,
"daily_cap_partner": 0,
"daily_cap_partners": [],
"landings": [],
"strictly_country": 0,
"strictly_os": [],
"strictly_brands": null,
"strictly_connection_type": "",
"is_redirect_overcap": false,
"notice_percent_overcap": 0,
"hold_period": 0,
"categories": [],
"full_categories": [],
"cr": 1.21,
"epc": 9.58,
"notes": null,
"allowed_ip": "",
"disallowed_ip": "",
"hash_password": "",
"allow_deeplink": 0,
"hide_referer": 0,
"start_at": "2018-11-05 12:35:00",
"stop_at": null,
"auto_offer_connect": null,
"required_approval": false,
"is_cpi": false,
"kpi": {
"ru": "",
"en": "",
"es": "",
"ka": "",
"vi": ""
},
"sub_restrictions": [],
"creatives": [],
"creatives_zip": null,
"sub_accounts": {
"1": {
"value": "",
"except": false
},
"2": {
"value": "",
"except": false
}
},
"redirect_type": "http302",
"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": []
}
],
"caps_timezone": "Europe/Moscow",
"strictly_isp": [],
"restriction_isp": [],
"strictly_devices": [],
"disabled_choice_postback_status": false,
"updated_at": "2019-01-07 11:41:52",
"created_at": "2019-01-05 11:08:31",
"caps_status": null,
"search_empty_sub": null,
"allow_impressions": false,
"smartlink_categories": [],
"click_session": "1y",
"minimal_click_session": null,
"io_document": null
}
}
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)
Get advertiser
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/advertiser/{id}
Response example:
{
"status": 1,
"advertiser": {
"id": "5b5f415035752723008b456a",
"title": "Test supplier",
"contact": null,
"email": null,
"url": null,
"manager": "",
"manager_obj": "",
"allowed_ip": [],
"disallowed_ip": [],
"skype": null,
"note": null,
"address_1": null,
"address_2": null,
"city": null,
"country": "AD",
"zip_code": null,
"vat_code": null,
"sub_accounts": {
"1": {
"value": null,
"except": false
},
"2": {
"value": null,
"except": false
}
},
"hash_password": null
}
}
Get advertiser
GET /3.0/admin/advertiser/{id}
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": "...",
"updated_at":null,
"created_at":null
}
],
"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 |
| updated_at | String | Get advertisers that have been updated from this date (format YYYY-MM-DD) |
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":[],
"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 | Available only letters(a-z), numbers(0-9) and these symbols: ,._-{}+=/:~ | Allowed sub1 values |
| sub_account_2 | String | Available only letters(a-z), numbers(0-9) and these symbols: ,._-{}+=/:~ | Allowed sub2 values |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Block sub1 values |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Block sub2 values |
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)
Count of active offers
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/offers/count
Response example:
{
"status": 1,
"count": 8
}
Get count of offers in status ‘active’
GET /3.0/offers/count
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",
"cross_postback_url":"http:\/\/test-url.com",
"url_preview":"http:\/\/preview.affise.com",
"preview_url":"http:\/\/preview.affise.com",
"domain_url":"affise.tds",
"use_https":false,
"use_http":true,
"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":{},
"strictly_connection_type": "wi-fi",
"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 12:35:00",
"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",
"minimal_click_session":"0s",
"external_offer_id":"5a97f4af94b814997c8b456a",
"sub_restrictions": [
{
"sub1": "sub_value1",
"sub2": "sub_value2"
}
],
"caps_timezone": "Europe/Moscow",
"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 (or put empty string to clear existing items)
country_exclude - Exclude these countries
cities - An array of id cities (or put empty string to clear existing items)
devices - The array of devices. Possible values: tablet, desktop, mobile, ipod (or put empty string to clear existing items)
os - Possible values (or put empty string to clear existing items)
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
cross_postback_url - Cross-postback URL
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 - String (OS). Possible values
versions - Array[string] OS versions with possible special chars >= or <. Possible values When adding OS targeting to the API offer, the version is a required parameter but can be an empty array value
Strictly identify ISP
country - String a country. ISO format
name - String a name. Possible values
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 | |
| cross_postback_url | String | Cross-postback URL | |
| macro_url | String | Additional macro | |
| url_preview | String | View URL | |
| trafficback_url | String | Trafficback URL | |
| domain_url | Integer | The domain Id for the tracking URL | |
| 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: “”, wi-fi, cellular | Strictly identify the connection type. Set a value to empty for choosing the all strictly connection type. |
| strictly_os | Array[string] | Deprecated : use restriction_os | |
| restriction_os | Array[string] | Strictly identify the operating system (See Structure) | |
| strictly_devices | Array[string] | Strictly identify the device (See Possible values) | |
| caps | Array[CapStructure] | Caps (See CapStructure) | |
| strictly_brands | Array[string] | Vendors (See Vendors) | |
| caps_status | Array[string] | Array of conversion statuses for caps calculation. Available values: “confirmed”, “pending”, “hold”, “not_found”, “declined” | |
| caps_timezone | String | Select timezone of conversions calculating for caps with periods day/month | |
| 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 HH:MM:SS | Date time 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) |
| minimal_click_session | String | Default: 0s | Minimal 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 | Available only letters(a-z), numbers(0-9) and these symbols: ,._-{}+=/:~ | Allowed sub1 values |
| sub_account_2 | String | Available only letters(a-z), numbers(0-9) and these symbols: ,._-{}+=/:~ | Allowed sub2 values |
| sub_account_1_except | Integer | Default: 0 Available: 0, 1 |
Block sub1 values, set only with sub_account_1 |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Block sub2 values, set only with sub_account_2 |
| smartlink_categories | Array[string] | Smartlink category ID. Use /3.0/admin/smartlink/categories to get an ID. Use empty value to remove a Smartlink category from an offer. | |
| 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 |
| rejectNotUniqIp | Integer | Default: 0 Available: 0, 1 |
Reject not unique Ip flag |
| strictly_isp | Array[string] | Deprecated : use restriction_isp | |
| restriction_isp | Array[string] | Stricly ISP (See Structure) | |
| 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",
"cross_postback_url":"http:\/\/test-url.com",
"url_preview":"http:\/\/preview.affise.com",
"preview_url":"http:\/\/preview.affise.com",
"domain_url":"affise.tds",
"use_https":false,
"use_http":true,
"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":{},
"strictly_connection_type": "wi-fi",
"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 12:35:00",
"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",
"minimal_click_session":"0s",
"sub_restrictions": [
{
"sub1": "sub_value1",
"sub2": "sub_value2"
}
],
"caps_timezone": "Europe/Moscow",
"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 | |
| cross_postback_url | String | Cross-postback URL | |
| macro_url | String | Additional macro | |
| url_preview | String | View URL | |
| trafficback_url | String | Trafficback URL | |
| domain_url | Integer | The domain Id for the tracking URL | |
| 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: “”, wi-fi, cellular | Strictly identify the connection type. Set a value to empty for choosing the all strictly connection type. |
| strictly_os | Array[string] | Deprecated : use restriction_os | |
| restriction_os | Array[string] | Strictly identify the operating system (See add offer) | |
| strictly_devices | Array[string] | Strictly identify the device (See Possible values) | |
| 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” | |
| caps_timezone | String | Select timezone of conversions calculating for caps with periods day/month | |
| 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 HH:MM:SS | Date time 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) |
| minimal_click_session | String | Default: 0s | Minimal 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 set only with sub_account_1 |
| sub_account_2_except | Integer | Default: 0 Available: 0, 1 |
Except Sub2 list set only with sub_account_2 |
| smartlink_categories | Array[string] | Smartlink category ID. Use /3.0/admin/smartlink/categories to get an ID. Use empty value to remove a Smartlink category from an offer. | |
| 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 |
| rejectNotUniqIp | Integer | Default: 0 Available: 0, 1 |
Reject not unique Ip flag |
| strictly_isp | Array[string] | Deprecated : use restriction_isp | |
| restriction_isp | Array[string] | Stricly ISP (See Structure) | |
| 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 | 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)
Get affiliate
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/partner/{id}
Response example:
{
"status": 1,
"partner": {
"id": 1,
"created_at": "2015-08-25 15:10:16",
"updated_at": "0000-00-00 00:00:00",
"email": "demo@demo.com",
"login": "demo@demo.com",
"ref_percent": null,
"name": "",
"notes": "",
"manager": null,
"status": "active",
"level": 5,
"payment_systems": [],
"customFields": [],
"balance": {
"RUB": {
"balance": 0,
"hold": 0,
"available": 0
},
"USD": {
"balance": 0,
"hold": 0,
"available": 0
},
"EUR": {
"balance": 0,
"hold": 0,
"available": 0
}
},
"offersCount": 0,
"api_key": "39ab3b372f26e65f4caa4f36e953b912d460343b",
"address_1": null,
"address_2": null,
"city": null,
"country": null,
"zip_code": null,
"phone": null,
"ref": "0"
},
"id": 1
}
Get affiliate
GET /3.0/admin/partner/{id}
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 | |
| updated_at | String | Get partners that have been updated from this date (format YYYY-MM-DD) |
New affiliate
curl -X POST \
http://api.dev.affise.com/3.0/admin/partner \
-H 'api-key: b12140975f18c5b088fd6e90ed5a4f26facbc117' \
-F password=qwerty123456 \
-F email=affise@gmail.com \
-F login=ivan.ivanov \
-F ref_percent=2 \
-F notes=note \
-F status=active \
-F level=1 \
-F manager_id=5cd5530ad596c1c0008b4567 \
-F 'custom_fields[1]=skype' \
-F ref=2 \
-F sub_account_1=sub1 \
-F sub_account_2=sub2 \
-F sub_account_1_except=0 \
-F sub_account_2_except=1 \
-F 'payment_systems[0][fields][1]=BA731035962466786892' \
-F 'payment_systems[0][fields][2]=PK83DELLCTnbVB5RMU5TL1X4' \
-F 'payment_systems[0][currency]=USD' \
-F 'payment_systems[0][system_id]=1'
Response example:
{
"status": 1,
"partner": {
"id": 5,
"created_at": "2019-07-16 16:55:45",
"updated_at": "2019-07-16 16:55:45",
"email": "affise@gmail.com",
"login": "treva.jones",
"ref_percent": "2",
"name": null,
"notes": "note",
"manager": {
"id": "5cd5530ad596c1c0008b4567",
"first_name": "admin",
"last_name": "admin",
"work_hours": "24",
"email": "admin@admin.adm",
"skype": "admin",
"api_key": "7eed552d6477f30f4b66fa663c4dfcab42eee7a4",
"roles": [
"ROLE_MANAGER_AFFILIATE"
],
"updated_at": null
},
"status": "active",
"level": 1,
"payment_systems": [
{
"id": 3,
"active": 0,
"system": "Webmoney",
"fields": {
"1": "BA731035962466786892",
"2": "PK83DELLCTnbVB5RMU5TL1X4"
}
}
],
"customFields": [
{
"name": "Skype",
"value": "skype",
"label": "skype",
"id": 1
}
],
"balance": {
"RUB": {
"balance": 0,
"hold": 0,
"available": 0
},
"USD": {
"balance": 0,
"hold": 0,
"available": 0
},
"EUR": {
"balance": 0,
"hold": 0,
"available": 0
},
"BTC": {
"balance": 0,
"hold": 0,
"available": 0
}
},
"offersCount": 0,
"api_key": "eff64a90010faabc92f845a7969a618986478993",
"address_1": null,
"address_2": null,
"city": null,
"country": null,
"zip_code": null,
"phone": null,
"ref": "2",
"sub_accounts": {
"1": {
"value": "sub1",
"except": 0
},
"2": {
"value": "sub2",
"except": 1
}
}
},
"id": 5
}
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 | |
| 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 affiliate
curl -X POST \
http://api.dev.affise.com/3.0/admin/partner/5 \
-H 'api-key: b12140975f18c5b088fd6e90ed5a4f26facbc117' \
-F password=qwerty123456 \
-F email=affise@gmail.com \
-F login=dima.ivanov \
-F ref_percent=2 \
-F notes=note \
-F status=active \
-F level=1 \
-F manager_id=5cd5530ad596c1c0008b4567 \
-F 'custom_fields[1]=skype' \
-F ref=2 \
-F sub_account_1=sub1 \
-F sub_account_2=sub2 \
-F sub_account_1_except=0 \
-F sub_account_2_except=1 \
-F 'payment_systems[0][fields][1]=BA731035962466786892' \
-F 'payment_systems[0][fields][2]=PK83DELLCTnbVB5RMU5TL1X4' \
-F 'payment_systems[0][currency]=USD' \
-F 'payment_systems[0][system_id]=1'
Response example:
{
"status": 1,
"partner": {
"id": 5,
"created_at": "2019-07-16 16:55:45",
"updated_at": "2019-07-16 17:17:05",
"email": "affise@gmail.com",
"login": "dima.ivanov",
"ref_percent": "2",
"name": null,
"notes": "note",
"manager": {
"id": "5cd5530ad596c1c0008b4567",
"first_name": "admin",
"last_name": "admin",
"work_hours": "24",
"email": "admin@admin.adm",
"skype": "admin",
"api_key": "7eed552d6477f30f4b66fa663c4dfcab42eee7a4",
"roles": [
"ROLE_MANAGER_AFFILIATE"
],
"updated_at": null
},
"status": "active",
"level": 1,
"payment_systems": [
{
"id": 3,
"active": 0,
"system": "Webmoney",
"fields": {
"1": "BA731035962466786892",
"2": "PK83DELLCTnbVB5RMU5TL1X4"
}
},
{
"id": 4,
"active": 0,
"system": "Webmoney",
"fields": {
"1": "BA731035962466786892",
"2": "PK83DELLCTnbVB5RMU5TL1X4"
}
}
],
"customFields": [
{
"name": "Skype",
"value": "skype",
"label": "skype",
"id": 1
}
],
"balance": {
"RUB": {
"balance": 0,
"hold": 0,
"available": 0
},
"USD": {
"balance": 0,
"hold": 0,
"available": 0
},
"EUR": {
"balance": 0,
"hold": 0,
"available": 0
},
"BTC": {
"balance": 0,
"hold": 0,
"available": 0
}
},
"offersCount": 0,
"api_key": "eff64a90010faabc92f845a7969a618986478993",
"address_1": null,
"address_2": null,
"city": null,
"country": null,
"zip_code": null,
"phone": null,
"ref": "2",
"sub_accounts": {
"1": {
"value": "sub1",
"except": 0
},
"2": {
"value": "sub2",
"except": 1
}
}
},
"id": 5
}
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 | |
| 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 |
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 (value) | |
| pid | Integer | REQUIRED Only for admin role 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 (value) | |
| pid | Integer | REQUIRED Only for admin role 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,
"updated_at":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 | |
| updated_at | String | Get users that have been updated from this date (format YYYY-MM-DD) |
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_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_PARTNER - Affiliate section
ROLE_SECTION_PAYMENT - Billing section
ROLE_SECTION_TICKET - Ticket section
ROLE_SECTION_OFFER - Offer 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_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
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 | |
| 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 |
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 | |
| list[0][custom_field_1] | String | custom field 1 | |
| list[0][custom_field_2] | String | custom field 2 | |
| list[0][custom_field_3] | String | custom field 3 | |
| list[0][custom_field_4] | String | custom field 4 | |
| list[0][custom_field_5] | String | custom field 5 | |
| list[0][custom_field_6] | String | custom field 6 | |
| list[0][custom_field_7] | String | custom field 7 |
Other managing (admin methods)
City list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/cities
Response example:
{
"cities":[
{
"country_code": "DE",
"id": 79729,
"name": "Thallichtenberg",
"region_code": "Rheinland-Pfalz"
},
{
"country_code": "DE",
"id": 40034,
"name": "Sindelfingen",
"region_code": "Baden-Wurttemberg"
},
{
"country_code": "DE",
"id": 75980,
"name": "Hofkirchen",
"region_code": "Bayern"
}
],
"pagination":{
"page":1,
"per_page":2147483647,
"total_count":3
},
"status":1
}
Get city list
GET /3.1/cities
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| country | Comma Separated Array of string | REQUIRED Country code. Example : US | |
| q | String | Search query | |
| code | Comma Separated Array of integer | City codes for filter |
Devices list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/devices
Response example:
{
"status":1,
"types":[
"SmartPhone",
"Desktop",
"Console",
"MediaHub",
"SmallScreen",
"Mobile",
"Tablet",
"EReader",
"Tv",
"SmartWatch"
]
}
Get list of devices
GET /3.1/devices
Vendors list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/vendors?q=next
Response example:
{
"status":1,
"vendors":[
"Nextbit",
"Next",
"NextBook",
"NEXTAB",
"Nextel",
"NextTab",
"NEXTPAD",
"NextWolf"
]
}
Get vendors list
GET /3.1/vendors
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| q | String | Search query |
Browsers list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/browsers
Response example:
{
"browsers":[
"Yahoo Mobile Messenger for Android",
"Dillo",
"lolifox",
"Facebook for Windows",
"Web Light",
"CometBird",
"MetaCert Safe iPad Browser"
],
"pagination":{
"page":1,
"per_page":2147483647,
"total_count":527
},
"status":1
}
Get browsers list
GET /3.1/browsers
Oses list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/oses
Response example:
{
"oses":{
"0":"Firefox OS",
"1":"3DS System Software",
"2":"DSi System Software",
"4":"VictorReader Stream",
"5":"ThreadX",
"6":"Feedfetcher",
"7":"Maemo",
"8":"Series 60",
"9":"Android with AOKP",
"10":"Apple TV Software"
},
"pagination":{
"page":1,
"per_page":2147483647,
"total_count":99
},
"status":1
}
Get oses list
GET /3.1/oses
OS versions list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/oses/macOS
Response example:
{
"pagination":{
"page":1,
"per_page":2147483647,
"total_count":21
},
"status":1,
"versions":[
"11.0",
"10.12",
"10.13",
"10.19",
"10.17",
"10.16",
"10.18",
"10.12.1",
"10.12.2",
"10.12.3",
"10.12.4",
"10.12.5",
"10.12.6",
"10.13.1",
"10.13.2",
"10.13.4",
"10.13.3",
"10.14.0",
"10.12.8",
"10.13.5",
"10.13.6"
]
}
Get os versions list
GET /3.1/oses/{OS}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| OS | String | One of OS |
Currency list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/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":[
{
"id":1,
"url":"domain1.com",
"use_https": false
},
{
"id":2,
"url":"domain2.com",
"use_https": false
}
]
}
Get domains
GET /3.0/admin/domains
Get ticket
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.0/admin/ticket/{id}
Response example:
{
"status": 1,
"ticket": {
"id": "1",
"status": "closed",
"type": "common",
"title": "Connect offer",
"description": "I want to connect offer",
"partner": {
"id": 3,
"created_at": "2018-06-20 14:42:40",
"updated_at": "2018-06-20 14:42:40",
"email": "testtest@gmail.com",
"login": "testtest@gmail.com",
"ref_percent": null,
"name": "",
"notes": "",
"manager": null,
"status": "not active",
"level": 0,
"payment_systems": [],
"customFields": [],
"balance": {
"USD": {
"balance": 0,
"hold": 0,
"available": 0
}
},
"offersCount": 0,
"api_key": "742638e984afa1dc12983966b4d424228b483b30",
"address_1": null,
"address_2": null,
"city": null,
"country": null,
"zip_code": null,
"phone": null,
"ref": null
},
"offer": {
"id": 9,
"offer_id": "5b2ba4beb861fd58ad8b4670",
"title": "Offer",
"preview_url": "http://link.preview.com",
"description": "",
"cr": 7,
"epc": 0,
"logo": "",
"logo_source": null,
"stop_at": null,
"sources": [],
"categories": [],
"full_categories": [],
"countries": null,
"payments": [
{
"countries": [],
"cities": [],
"country_exclude": false,
"title": "RevShare",
"goal": "1",
"currency": "USD",
"type": "percent",
"devices": [],
"os": []
},
{
"countries": [],
"cities": [],
"country_exclude": false,
"title": "Deposit",
"goal": "3",
"revenue": 0,
"currency": "USD",
"type": "fixed",
"devices": [],
"os": []
}
],
"goals": {
"1": "RevShare",
"2": "RevShare",
"3": "Deposit",
"4": "Registration"
},
"caps": [],
"caps_timezone": "Europe/Moscow",
"cap": 0,
"hide_caps": 0,
"required_approval": false,
"strictly_country": 1,
"strictly_os": [],
"strictly_brands": null,
"is_cpi": false,
"kpi": {
"en": ""
},
"creatives": [],
"creatives_zip": null,
"landings": [],
"links": [],
"macro_url": "",
"link": null,
"use_https": false,
"use_http": true,
"hold_period": 0,
"click_session": "1y",
"disabled_choice_postback_status": false,
"strictly_isp": [],
"restriction_isp": [],
"impressions_link": null
},
"attachments": [
"http:\/\/api.dev.affise.com\/3.0\/admin\/ticket\/file\/23\/faafe9b1df79e05f4eaf8e6516d7bfafbde2e1f4.png"
],
"created": "2018-09-12 12:05:18",
"updated": null
},
"id": "1"
}
Get ticket
GET /3.0/admin/ticket/{id}
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
},
"attachments": [
"http:\/\/api.dev.affise.com\/3.0\/admin\/ticket\/file\/23\/faafe9b1df79e05f4eaf8e6516d7bfafbde2e1f4.png"
],
"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: Pending: 0, Rejected: -1, Approved: 1 | 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: Pending: 0, Rejected: -1, Approved: 1 | 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,
"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",
"created_at":"2017-07-07 18:35:51",
"updated_at":"2017-07-07 18:35:51"
}
}
Add new SmartLink category
POST /3.0/admin/smartlink/category
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | REQUIRED Category name | |
| domain_id | Integer | Keep it empty to set the default TDS domain or use domain ID from GET /3.0/admin/domains | |
| description | String | Category description |
Smartlink edit 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",
"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 |
SmartLink category remove
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",
"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
SmartLink offer count
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "" http://YOUR_API_DOMAIN/3.0/admin/smartlink/category/595fd4877e28fee8428b459f/offers-count
Response example:
{
"status":1,
"data":{
"count":2
}
}
Add new SmartLink category
GET /3.0/admin/smartlink/category/{id}/offers-count
Other managing
ISP list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/isp?country=kz
Response example:
{
"isps":[
{
"country":"KZ",
"name":"reliablesite.net llc"
},
{
"country":"KZ",
"name":"smartnet too"
},
{
"country":"KZ",
"name":"betting office olimp kz llc"
}
],
"pagination":{
"page":1,
"per_page":2147483647,
"total_count":3
},
"status":1
}
Get ISP list
GET /3.1/isp
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| country | String | REQUIRED Country code. Example: “US” | |
| q | String | Search query |
Countries list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/countries
Response example:
{
"countries":[
{
"code":"KP",
"name":"North Korea"
},
{
"code":"PF",
"name":"French Polynesia"
},
{
"code":"EG",
"name":"Egypt"
},
{
"code":"DE",
"name":"Germany"
},
{
"code":"GI",
"name":"Gibraltar"
}
],
"status":1
}
Get countries list
GET /3.1/countries
Connection types list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/connection-types
Response example:
{
"status":1,
"types":[
"wi-fi",
"cellular",
"other"
]
}
Get connection types list
GET /3.1/connection-types