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. Only for users with special permission: trafficback_reason |
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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 /3.0/admin/currency |
| filter[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | 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 |
| currency | Integer | ID currency |
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[integer] | 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 | |
| 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 partner postback
curl -X GET \
'http://<YOUR_DOMAIN>/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 | |
| 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 cap
curl -X GET \
'http://<YOUR_DOMAIN>/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[integer] | 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
By trafficback
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN}/3.0/stats/getbytrafficback?filter[date_from]=2019-12-09&filter[date_to]=2019-12-12
Response example:
{
"status": 1,
"stats": [
{
"slice": {
"trafficback_reason": "unknown-affiliate"
},
"traffic": {
"raw": "0",
"uniq": "0"
},
"actions": [],
"views": 0,
"ctr": 0,
"trafficback": 1
},
{
"slice": {
"trafficback_reason": "invalid-affiliate"
},
"traffic": {
"raw": "0",
"uniq": "0"
},
"actions": [],
"views": 0,
"ctr": 0,
"trafficback": 47
}
],
"pagination": {
"per_page": 100,
"total_count": 2,
"page": 1
}
}
Get statistics by trafficback
GET /3.0/stats/getbytrafficback
| 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[advertiser] | Mixed: String or Array[string] | Advertiser ID’s | |
| filter[offer] | Array[integer] | Offers 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” |
Retention rate
curl -X GET \
'http://<YOUR_DOMAIN>/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
Time to action
curl -X GET \
'http://<YOUR_DOMAIN>/3.0/stats/time-to-action?timezone=Europe/Moscow&affiliate_ids=70,71&date_from=2019-11-16&date_to=2019-11-18&offer_id=7' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
Response example:
{
"data": [
{
"affiliate_id": 70,
"clicks": 90,
"total_conversions": 4,
"tta_30": 3,
"tta_600": 1,
"tta_inf": 0
}
],
"status": 200,
"pagination": {
"total_count": 1,
"per_page": 100,
"page": 1
}
}
Get Time to action report
GET /3.0/stats/time-to-action
| 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_id | Integer | REQUIRED An offer id | |
| timezone | string | REQUIRED Timezone | Timezone name. Example: “Europe/Berlin” |
| goal | string | Name based goal | |
| affiliate_ids | integer | Affiliates filter. Comma separated int values | |
| page | Integer | Default: 1 | Page of stat entities |
| limit | Integer | Default: 100 | Limit of stat entities |
Affiliate methods
Get partner own data
curl -X GET \
'http://YOUR_API_DOMAIN/3.1/partner/me' \
-H 'api-key: {API-KEY}'
Response example:
{
"status": 1,
"user": {
"id": "5d91e81acbe5a8fd53e7215d",
"api_key": "cd21e0d96fdfcd181403531854bba48f",
"info": null,
"created_at": "2019-09-30T11:33:46Z",
"settings": null,
"email": "test1.users-stage-v1@cud.partner",
"login": "test11.users-stage-v1@cud.partner",
"name": null,
"company": null,
"status": "1",
"updated_at": "2019-10-02T07:28:01Z",
"confirm_code": null,
"ref": null,
"lang": "en",
"timezone": null,
"level": null,
"manager_id": "",
"notes": "",
"ref_percent": null,
"pay_sys": null,
"pay_acc": "",
"pay_acc_wmz": "",
"balance_ru": "0.00",
"hold_ru": "0.00",
"available_ru": "0.00",
"balance_usd": "0.00",
"hold_usd": "0.00",
"available_usd": "0.00",
"address_1": null,
"address_2": null,
"city": null,
"country": "GH",
"zip_code": null,
"phone": null,
"shave": null,
"sub_accounts": {
"1": {
"value": "",
"except": 0
},
"2": {
"value": "",
"except": 0
}
},
"type": "affiliate",
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
}
},
"billing": {
"entity-affiliate": {
"level": "deny",
"exceptions": []
}
},
"offers": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-offer": {
"level": "deny",
"exceptions": {
"strings": []
}
}
},
"stats": {
"affiliate-postback": {
"level": "deny",
"exceptions": []
},
"comparison-report": {
"level": "deny",
"exceptions": []
},
"conversions-import": {
"level": "deny",
"exceptions": []
},
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-click": {
"level": "deny",
"exceptions": []
},
"entity-conversions": {
"level": "deny",
"exceptions": []
},
"entity-offer": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-smartlink": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"referral": {
"level": "deny",
"exceptions": []
},
"server-postback": {
"level": "deny",
"exceptions": []
},
"slice-advertiser_id": {
"level": "deny",
"exceptions": []
},
"slice-affiliate_id": {
"level": "deny",
"exceptions": []
},
"slice-city": {
"level": "deny",
"exceptions": []
},
"slice-connection-type": {
"level": "deny",
"exceptions": []
},
"slice-country": {
"level": "deny",
"exceptions": []
},
"slice-day": {
"level": "deny",
"exceptions": []
},
"slice-device": {
"level": "deny",
"exceptions": []
},
"slice-goal": {
"level": "deny",
"exceptions": []
},
"slice-landing": {
"level": "deny",
"exceptions": []
},
"slice-mobile-carrier": {
"level": "deny",
"exceptions": []
},
"slice-offer_id": {
"level": "deny",
"exceptions": []
},
"slice-os": {
"level": "deny",
"exceptions": []
},
"view-custom": {
"level": "deny",
"exceptions": []
},
"view-kpi": {
"level": "deny",
"exceptions": []
},
"view-retention-rate": {
"level": "deny",
"exceptions": []
}
},
"users": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-common-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"view-users": {
"level": "deny",
"exceptions": []
}
}
},
"work_hours": "",
"last_login_at": "2019-10-02T07:29:22Z"
}
}
Get partner own data
GET /3.1/partner/me
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":"..."
}
],
"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":"..."
}
],
"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"
},
"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,
"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) | |
| is_top | Integer | Available: 0, 1 | Get TOP-offers |
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": ""
},
"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",
"title": "...",
"type": "fixed",
"url": null,
"country_exclude": false,
"with_regions": false
},
{
"countries": [],
"cities": [],
"devices": [],
"os": [],
"goal": "4",
"total": 1600,
"revenue": 1020,
"currency": "rub",
"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",
"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",
"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"
},
"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,
"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"
],
"caps_goal_overcap" : "install"
},
"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: mediahub, mobile, ereader, console, tv, tablet, desktop, smartwatch (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
sub1 … subN - Comma-separated sub values. N is number in range 1..8. Example: sub1=subVal1,subVal2
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, clicks
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.
country - Array[string]. Values: Country codes.
country_type - [string]. Values: “all” , “each”, “exact”. “country” 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 |
| 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 | |
| creativeDownloads | Array[string] | An array of URLs to external creative resources for download | |
| 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 |
| caps_goal_overcap | String | Enabled - When cap for chosen default goal is reached, clicks would be redirected to Trafficback url | |
| targeting | Array[TargetingGroupStructure] | Array of targeting groups (See Structure) |
Targeting group structure
JSON structure example
PHP example
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| country[allow/deny] | Array[string] | countries ISO codes | list of allowed/denied countries. Example: country[allow][]=US |
| region[allow/deny][countryISO] | Array[Integer] | region codes | list of allowed/denied regions for chosen country(ISO). Example: region[allow][US]=33 |
| city[allow/deny][countryISO] | Array[Integer] | city codes | list of allowed/denied cities for chosen country(ISO). Example: city[allow][US]=57 |
| os[allow] | Array[Ostructure] | list of allowed OSes and them versions. To deny specific version should use according comparison operation. (See OS Structure) | |
| isp[allow][countryISO] | Array[String] | ISP list | list of allowed ISP for chosen country(ISO). Example: isp[allow][US]=Att |
| ip[allow/deny] | Array[string] | list of allowed/denied ip ranges (IPv4 , IPv6). Available formats : “100.0.0.1” (single IP), “100.0.0.1-100.0.0.255” (IP range), “222.1.1.20/26” (IP/mask) | |
| device_type | Array[string] | “mobile”, “tablet”, “desktop”, “mediahub”, “ereader”, “console”, “tv”, “smartwatch” | list of allowed device types. |
| browser[allow/deny] | Array[string] | list of allowed/denied browsers. Example: browser[deny][] = “Edge” | |
| brand[allow/deny] | Array[string] | list of allowed/denied device brands. Example: brand[deny][] = “SAMTEL” | |
| sub[allow/deny][subNumber] | Array[string] | list of allowed/denied subs for chosen sub parameter. Example: sub[allow][2][]=“subValue” | |
| sub[deny_groups][groupNumber][subNumber] | String | list of denied sub restricted groups (when is needed to block sub pairs(and more): sub1=“A” + sub2=“B”). Example: sub[deny_groups][0][1]=“A” + sub[deny_groups][0][2]=“B”. To implement “Block traffic if empty sub” option, put empty string in the group : sub[deny_groups][1][8]=“” | |
| connection | Array[string] | “wi-fi”, “cellular” | list of allowed connection types. |
| block_proxy | Integer | 0, 1 | enable/disable “Click-level Anti-fraud” feature |
| affiliate_id | Array[Integer] | list of affiliates for personal targeting groups. | |
| url | String | Additional Tracking URL |
OS structure
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | String | OS name that could be found at OSes list method. | |
| comparison | String | LT, LTE, EQ, GT, GTE | Comparison operation for OS version. |
| version | String | OS version for comparision. |
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"
},
"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,
"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"
],
"caps_goal_overcap" : "install"
},
"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 |
| 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 | |
| creativeDownloads | Array[string] | An array of URLs to external creative resources for download | |
| 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 |
| caps_goal_overcap | String | Enabled - When cap for chosen default goal is reached, clicks would be redirected to Trafficback url | |
| targeting | Array[TargetingGroupStructure] | Array of targeting groups (See Structure) |
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",
"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",
"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 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",
"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 |
| 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 |
| notify | Integer | Default: 0 Available: 0, 1 |
Send welcome email to affiliate |
| tipalti_payee_id | Integer | Tipalti Payee ID |
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 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",
"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 |
| 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 |
| tipalti_payee_id | Integer | Tipalti Payee ID |
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 |
Change partner api key
curl -X POST \
'http://YOUR_API_DOMAIN/3.1/partner/api-key' \
-H 'api-key: {API-KEY}'
Response example:
{
"status": 1,
"user": {
"id": 1,
"api_key": "97366c88ad626fdf4c73687d2cae5394"
}
}
Change partner api key
POST /3.1/partner/api_key
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
Change user api key
POST /3.0/admin/user/api_key/{ID}
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 password
Change user password
POST /3.0/admin/user/{ID}/password
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
--data "http://YOUR_API_DOMAIN/3.0/admin/user/594927bd7e28fe1c4a8b4569/password"
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| password | String | Available: at least 6 characters | REQUIRED Password |
Response example:
{
"status":1,
"user":{
"id":"594927bd7e28fe1c4a8b4569",
"password":"c740955e768795098c8b91ef40ec008526f3f884"
}
}
Update user permissions
Update user permissions
POST /3.1/user/{ID}/permissions
curl -X POST \
'http://api.dev.affise.com/3.1/user/{ID}/permissions' \
-H 'Content-Type: application/json' \
-H 'api-key: {API-kEY}' \
-d '{
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": {}
}
}
},
"billing": {
"entity-affiliate": {
"level": "deny",
"exceptions": {}
}
},
"offers": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-offer": {
"level": "deny",
"exceptions": {
"strings": {}
}
}
},
"stats": {
"affiliate-postback": {
"level": "deny",
"exceptions": {}
},
"comparison-report": {
"level": "deny",
"exceptions": {}
},
"conversions-import": {
"level": "deny",
"exceptions": {}
},
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-click": {
"level": "deny",
"exceptions": {}
},
"entity-conversions": {
"level": "deny",
"exceptions": {}
},
"entity-offer": {
"level": "deny",
"exceptions": {
"ints": {}
}
},
"entity-smartlink": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"referral": {
"level": "deny",
"exceptions": {}
},
"server-postback": {
"level": "deny",
"exceptions": {}
},
"slice-advertiser_id": {
"level": "deny",
"exceptions": {}
},
"slice-affiliate_id": {
"level": "deny",
"exceptions": {}
},
"slice-city": {
"level": "deny",
"exceptions": {}
},
"slice-connection-type": {
"level": "deny",
"exceptions": {}
},
"slice-country": {
"level": "deny",
"exceptions": {}
},
"slice-day": {
"level": "deny",
"exceptions": {}
},
"slice-device": {
"level": "deny",
"exceptions": {}
},
"slice-goal": {
"level": "deny",
"exceptions": {}
},
"slice-landing": {
"level": "deny",
"exceptions": {}
},
"slice-mobile-carrier": {
"level": "deny",
"exceptions": {}
},
"slice-offer_id": {
"level": "deny",
"exceptions": {}
},
"slice-os": {
"level": "deny",
"exceptions": {}
},
"view-custom": {
"level": "deny",
"exceptions": {}
},
"view-kpi": {
"level": "deny",
"exceptions": {}
},
"view-retention-rate": {
"level": "deny",
"exceptions": {}
}
},
"users": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"entity-common-manager": {
"level": "deny",
"exceptions": {
"strings": {}
}
},
"view-users": {
"level": "deny",
"exceptions": {}
}
}
}
}'
Response example:
{
"status": 1,
"permissions": {
"id": "5d3ece3669d0d539f965bfb3",
"email": "testapi31@test.com",
"type": "common_manager",
"first_name": "Affiliate_api",
"last_name": "Affiliate_api",
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
}
},
"billing": {
"entity-affiliate": {
"level": "deny",
"exceptions": []
}
},
"conversions": {
"conversions-import": {
"level": "deny",
"exceptions": []
},
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-conversions": {
"level": "deny",
"exceptions": []
},
"entity-offer": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-smartlink": {
"level": "deny",
"exceptions": {
"strings": []
}
}
},
"offers": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-offer": {
"level": "deny",
"exceptions": {
"strings": []
}
}
},
"stats": {
"affiliate-postback": {
"level": "deny",
"exceptions": []
},
"comparison-report": {
"level": "deny",
"exceptions": []
},
"conversions-import": {
"level": "deny",
"exceptions": []
},
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-click": {
"level": "deny",
"exceptions": []
},
"entity-conversions": {
"level": "deny",
"exceptions": []
},
"entity-offer": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-smartlink": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"referral": {
"level": "deny",
"exceptions": []
},
"server-postback": {
"level": "deny",
"exceptions": []
},
"slice-advertiser_id": {
"level": "deny",
"exceptions": []
},
"slice-affiliate_id": {
"level": "deny",
"exceptions": []
},
"slice-city": {
"level": "deny",
"exceptions": []
},
"slice-connection-type": {
"level": "deny",
"exceptions": []
},
"slice-country": {
"level": "deny",
"exceptions": []
},
"slice-day": {
"level": "deny",
"exceptions": []
},
"slice-device": {
"level": "deny",
"exceptions": []
},
"slice-goal": {
"level": "deny",
"exceptions": []
},
"slice-landing": {
"level": "deny",
"exceptions": []
},
"slice-mobile-carrier": {
"level": "deny",
"exceptions": []
},
"slice-offer_id": {
"level": "deny",
"exceptions": []
},
"slice-os": {
"level": "deny",
"exceptions": []
},
"view-custom": {
"level": "deny",
"exceptions": []
},
"view-kpi": {
"level": "deny",
"exceptions": []
},
"view-retention-rate": {
"level": "deny",
"exceptions": []
}
},
"users": {
"entity-account-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "deny",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"entity-common-manager": {
"level": "deny",
"exceptions": {
"strings": []
}
},
"view-users": {
"level": "deny",
"exceptions": []
}
}
},
"work_hours": "",
"api_key": "fd0f86ac72cabd79ad02303365889c6e",
"created_at": "2019-07-29T10:45:10Z",
"updated_at": "2019-10-01T10:31:40Z"
}
}
Read user
GET /3.0/admin/user/{ID}
Read single user
curl -X GET \
-H 'API-Key:23df424b0a53b0899f78685966243ee61'}
--data "http://YOUR_API_DOMAIN/3.0/admin/user/594927bd7e28fe1c4a8b4569"'
Response example:
{ "status": 1, "user": { "id": "5d5e7edebec46e3cd03c92d6", "first_name": "Test_User", "last_name": "Test_User", "work_hours": "", "email": "Test_User@test.com", "skype": "there_is_no_Skype Test_User", "api_key": "19491cfc0a3422e67e64fb2192e07bf0", "roles": [ "ROLE_MANAGER_AFFILIATE", "ROLE_MANAGER_SALES" ], "updated_at": "2019-08-27T08:18:06Z", "created_at": "2019-08-22T11:39:10Z", "info": null, "type": "account_manager", "contacts": { "skype": "there_is_no_Skype 3 Test_User" }, "permissions": { "advertisers": { "entity-advertiser": { "level": "deny", "exceptions": { "strings": [] } } }, "billing": { "entity-affiliate": { "level": "deny", "exceptions": [] } }, "offers": { "entity-account-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-advertiser": { "level": "deny", "exceptions": { "strings": [] } }, "entity-affiliate": { "level": "deny", "exceptions": { "ints": [] } }, "entity-affiliate-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-offer": { "level": "deny", "exceptions": { "strings": [] } } }, "stats": { "affiliate-postback": { "level": "deny", "exceptions": [] }, "comparison-report": { "level": "deny", "exceptions": [] }, "conversions-import": { "level": "deny", "exceptions": [] }, "entity-account-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-advertiser": { "level": "deny", "exceptions": { "strings": [] } }, "entity-affiliate": { "level": "deny", "exceptions": { "ints": [] } }, "entity-affiliate-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-conversions": { "level": "deny", "exceptions": [] }, "entity-offer": { "level": "deny", "exceptions": { "ints": [] } }, "entity-smartlink": { "level": "deny", "exceptions": { "strings": [] } }, "referral": { "level": "deny", "exceptions": [] }, "server-postback": { "level": "deny", "exceptions": [] }, "slice-advertiser_id": { "level": "deny", "exceptions": [] }, "slice-affiliate_id": { "level": "deny", "exceptions": [] }, "slice-city": { "level": "deny", "exceptions": [] }, "slice-country": { "level": "deny", "exceptions": [] }, "slice-day": { "level": "deny", "exceptions": [] }, "slice-device": { "level": "deny", "exceptions": [] }, "slice-goal": { "level": "deny", "exceptions": [] }, "slice-offer_id": { "level": "deny", "exceptions": [] }, "slice-os": { "level": "deny", "exceptions": [] }, "view-custom": { "level": "deny", "exceptions": [] } }, "users": { "entity-account-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-advertiser": { "level": "deny", "exceptions": { "strings": [] } }, "entity-affiliate": { "level": "deny", "exceptions": { "ints": [] } }, "entity-affiliate-manager": { "level": "deny", "exceptions": { "strings": [] } }, "entity-common-manager": { "level": "deny", "exceptions": { "strings": [] } }, "view-users": { "level": "deny", "exceptions": [] } } } }
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": {
"offer": 1000,
"pid": 500,
"action_id": null,
"goal": null,
"ip": null,
"ua": null,
"sum": null,
"comment": 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 | |
| click_id | String | Click ID | |
| goal | Integer | goal number | |
| ip | String | visitor ip | |
| ua | String | visitor user-agent | |
| comment | String | comment | |
| 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,
"comment": 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][click_id] | String | Click ID | |
| list[0][goal] | Integer | goal number | |
| list[0][ip] | String | visitor ip | |
| list[0][ua] | String | visitor user-agent | |
| list[0][comment] | String | comment | |
| 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":[
"mediahub",
"mobile",
"ereader",
"console",
"tv",
"tablet",
"desktop",
"smartwatch"
]
}
Get list of devices
GET /3.1/devices
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
Currency list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/admin/currency
Response examples:
{
"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 /3.0/admin/currency?extended=1
{
"status": 1,
"quotes": [
{
"_id": 2,
"code": "USD",
"active": true,
"default": true,
"rate": 1,
"min_payment": 20,
"is_crypto": null
}
]
}
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 |
| extended | integer | Default: 0 Available: 1 |
Extended currencies information |
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
Presets (admin methods)
Get list of presets
curl -X GET \
'http://<YOUR_DOAMIN>/3.1/presets' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
Response example:
{
"status": 1,
"presets": [
{
"id": "5d4bc80f10dd212ea8dc98ea",
"name": "Test affiliate_manager 3 (Test Me 2)",
"type": "common_manager",
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": []
}
}
},
"billing": {
"entity-affiliate": {
"level": "read",
"exceptions": []
}
},
"conversions": {
"conversions-import": {
"level": "read",
"exceptions": []
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-conversions": {
"level": "read",
"exceptions": []
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": []
}
}
},
"offers": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": []
}
}
},
"stats": {
"affiliate-postback": {
"level": "read",
"exceptions": []
},
"comparison-report": {
"level": "read",
"exceptions": []
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": []
}
},
"referral": {
"level": "read",
"exceptions": []
},
"server-postback": {
"level": "read",
"exceptions": []
},
"slice-advertiser_id": {
"level": "read",
"exceptions": []
},
"slice-affiliate_id": {
"level": "read",
"exceptions": []
},
"slice-city": {
"level": "read",
"exceptions": []
},
"slice-country": {
"level": "read",
"exceptions": []
},
"slice-day": {
"level": "read",
"exceptions": []
},
"slice-device": {
"level": "read",
"exceptions": []
},
"slice-goal": {
"level": "read",
"exceptions": []
},
"slice-offer_id": {
"level": "read",
"exceptions": []
},
"slice-os": {
"level": "read",
"exceptions": []
},
"view-custom": {
"level": "read",
"exceptions": []
}
},
"users": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": []
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"entity-common-manager": {
"level": "read",
"exceptions": {
"strings": []
}
},
"view-users": {
"level": "read",
"exceptions": []
}
}
},
"created_at": "2019-08-08T06:58:23Z",
"updated_at": "2019-08-08T14:23:37Z"
}
]
}
Get presets list
GET /3.1/presets
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| page | Integer | Available: >=1; 1 | page with results |
| limit | Integer | Available: >=1; 50 | results per page |
Create preset
curl -X POST \
'http://<YOUR_DOAMIN>/3.1/presets' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
-H 'Content-Type: application/json' \
-d '{
"name": "Test affiliate_manager 4",
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"billing": {
"entity-affiliate": {
"level": "read",
"exceptions": {}
}
},
"conversions": {
"conversions-import": {
"level": "read",
"exceptions": {}
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-conversions": {
"level": "read",
"exceptions": {}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"offers": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"stats": {
"affiliate-postback": {
"level": "read",
"exceptions": {}
},
"comparison-report": {
"level": "read",
"exceptions": {}
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"referral": {
"level": "read",
"exceptions": {}
},
"server-postback": {
"level": "read",
"exceptions": {}
},
"slice-advertiser_id": {
"level": "read",
"exceptions": {}
},
"slice-affiliate_id": {
"level": "read",
"exceptions": {}
},
"slice-city": {
"level": "read",
"exceptions": {}
},
"slice-country": {
"level": "read",
"exceptions": {}
},
"slice-day": {
"level": "read",
"exceptions": {}
},
"slice-device": {
"level": "read",
"exceptions": {}
},
"slice-goal": {
"level": "read",
"exceptions": {}
},
"slice-offer_id": {
"level": "read",
"exceptions": {}
},
"slice-os": {
"level": "read",
"exceptions": {}
},
"view-custom": {
"level": "read",
"exceptions": {}
}
},
"users": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-common-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"view-users": {
"level": "read",
"exceptions": {}
}
}
},
"type": "affiliate_manager"
}'
Response example:
[
{
"status": 1,
"preset": {
"id": "5d4c30c610dd212ea8dc98f5",
"name": "Test affiliate_manager",
"type": 3,
"scope_permissions": {
"advertisers": {
"permission": {
"entity-advertiser": 3
},
"exceptions": {
"entity-advertiser": {
"Exceptions": {
"String_": []
}
}
}
},
"billing": {
"permission": {
"entity-affiliate": 3
}
},
"conversions": {
"permission": {
"conversions-import": 3,
"entity-account-manager": 2,
"entity-advertiser": 2,
"entity-affiliate": 2,
"entity-affiliate-manager": 2,
"entity-conversions": 3,
"entity-offer": 2,
"entity-smartlink": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
},
"entity-smartlink": {
"Exceptions": {
"String_": []
}
}
}
},
"offers": {
"permission": {
"entity-account-manager": 3,
"entity-advertiser": 3,
"entity-affiliate": 3,
"entity-affiliate-manager": 3,
"entity-offer": 3
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
}
}
},
"stats": {
"permission": {
"affiliate-postback": 2,
"comparison-report": 2,
"entity-account-manager": 2,
"entity-advertiser": 2,
"entity-affiliate": 2,
"entity-affiliate-manager": 2,
"entity-offer": 2,
"entity-smartlink": 2,
"referral": 2,
"server-postback": 2,
"slice-advertiser_id": 2,
"slice-affiliate_id": 2,
"slice-city": 2,
"slice-country": 2,
"slice-day": 2,
"slice-device": 2,
"slice-goal": 2,
"slice-offer_id": 2,
"slice-os": 2,
"view-custom": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
},
"entity-smartlink": {
"Exceptions": {
"String_": []
}
}
}
},
"users": {
"permission": {
"entity-account-manager": 3,
"entity-advertiser": 3,
"entity-affiliate": 3,
"entity-affiliate-manager": 3,
"entity-common-manager": 3,
"view-users": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-common-manager": {
"Exceptions": {
"String_": []
}
}
}
}
},
"created_at": {
"seconds": 1565274310
},
"updated_at": {
"seconds": 1565274310
}
}
}
]
Create preset using JSON dataset
POST /3.1/presets
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | JSON | String | Preset name REQUIRED |
| permissions | JSON | full scope | REQUIRED Permissions for preset |
| type | JSON | affiliate_manager; account_manager; eq=common_manager | REQUIRED reset type |
Update preset
curl -X POST \
'http://<YOUR_DOAMIN>/3.1/presets/5d4c30c610dd212ea8dc98f5' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c' \
-H 'Content-Type: application/json' \
-d '{
"name": "Test affiliate_manager (udpate)",
"permissions": {
"advertisers": {
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"billing": {
"entity-affiliate": {
"level": "read",
"exceptions": {}
}
},
"conversions": {
"conversions-import": {
"level": "read",
"exceptions": {}
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-conversions": {
"level": "read",
"exceptions": {}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"offers": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
}
},
"stats": {
"affiliate-postback": {
"level": "read",
"exceptions": {}
},
"comparison-report": {
"level": "read",
"exceptions": {}
},
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-offer": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-smartlink": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"referral": {
"level": "read",
"exceptions": {}
},
"server-postback": {
"level": "read",
"exceptions": {}
},
"slice-advertiser_id": {
"level": "read",
"exceptions": {}
},
"slice-affiliate_id": {
"level": "read",
"exceptions": {}
},
"slice-city": {
"level": "read",
"exceptions": {}
},
"slice-country": {
"level": "read",
"exceptions": {}
},
"slice-day": {
"level": "read",
"exceptions": {}
},
"slice-device": {
"level": "read",
"exceptions": {}
},
"slice-goal": {
"level": "read",
"exceptions": {}
},
"slice-offer_id": {
"level": "read",
"exceptions": {}
},
"slice-os": {
"level": "read",
"exceptions": {}
},
"view-custom": {
"level": "read",
"exceptions": {}
}
},
"users": {
"entity-account-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-advertiser": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-affiliate": {
"level": "read",
"exceptions": {
"ints": {}
}
},
"entity-affiliate-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"entity-common-manager": {
"level": "read",
"exceptions": {
"strings": {}
}
},
"view-users": {
"level": "read",
"exceptions": {}
}
}
}
}'
Response example:
[
{
"status": 1,
"preset": {
"id": "5d4c30c610dd212ea8dc98f5",
"name": "Test affiliate_manager (update)",
"type": "affiliate_manage",
"scope_permissions": {
"advertisers": {
"permission": {
"entity-advertiser": 3
},
"exceptions": {
"entity-advertiser": {
"Exceptions": {
"String_": []
}
}
}
},
"billing": {
"permission": {
"entity-affiliate": 3
}
},
"conversions": {
"permission": {
"conversions-import": 3,
"entity-account-manager": 2,
"entity-advertiser": 2,
"entity-affiliate": 2,
"entity-affiliate-manager": 2,
"entity-conversions": 3,
"entity-offer": 2,
"entity-smartlink": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
},
"entity-smartlink": {
"Exceptions": {
"String_": []
}
}
}
},
"offers": {
"permission": {
"entity-account-manager": 3,
"entity-advertiser": 3,
"entity-affiliate": 3,
"entity-affiliate-manager": 3,
"entity-offer": 3
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
}
}
},
"stats": {
"permission": {
"affiliate-postback": 2,
"comparison-report": 2,
"entity-account-manager": 2,
"entity-advertiser": 2,
"entity-affiliate": 2,
"entity-affiliate-manager": 2,
"entity-offer": 2,
"entity-smartlink": 2,
"referral": 2,
"server-postback": 2,
"slice-advertiser_id": 2,
"slice-affiliate_id": 2,
"slice-city": 2,
"slice-country": 2,
"slice-day": 2,
"slice-device": 2,
"slice-goal": 2,
"slice-offer_id": 2,
"slice-os": 2,
"view-custom": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-offer": {
"Exceptions": {
"String_": []
}
},
"entity-smartlink": {
"Exceptions": {
"String_": []
}
}
}
},
"users": {
"permission": {
"entity-account-manager": 3,
"entity-advertiser": 3,
"entity-affiliate": 3,
"entity-affiliate-manager": 3,
"entity-common-manager": 3,
"view-users": 2
},
"exceptions": {
"entity-account-manager": {
"Exceptions": {
"String_": []
}
},
"entity-advertiser": {
"Exceptions": {
"String_": []
}
},
"entity-affiliate": {
"Exceptions": {
"Int": []
}
},
"entity-affiliate-manager": {
"Exceptions": {
"String_": []
}
},
"entity-common-manager": {
"Exceptions": {
"String_": []
}
}
}
}
},
"created_at": {
"seconds": 1565274310
},
"updated_at": {
"seconds": 1565274310
}
}
}
]
Update preset using JSON dataset
POST /3.1/presets/{preset_id}
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| name | JSON | String | Preset name |
| permissions | JSON | full scope | REQUIRED Permissions for preset |
Delete preset
curl -X DELETE \
'http://<YOUR_DOAMIN>/3.1/presets/5d4c30c610dd212ea8dc98f5' \
-H 'api-key: 69cebe280a74bb8863a6d2b37df1f72b910e6a7c'
Response example:
{
"status": 1
}
Delete preset by id
DELETE /3.1/presets/{preset_id}
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
Regions list
curl --header "API-Key:23df424b0a53b0899f78685966243ee61" /
http://YOUR_API_DOMAIN/3.1/regions?country[]=US
Response example:
{
"status":1,
"regions":[
{
"id":2,
"name":"Alaska",
"country_code":"US"
},
{
"id":1,
"name":"Alabama",
"country_code":"US"
}
]
}
Get region list
GET /3.1/regions
| Parameter | Type | Available & Default | Description |
|---|---|---|---|
| country | String | REQUIRED Country code. Example: “US” |
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
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 |
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 |
Status Codes
Review all global errors for the API so you can get back to work fast.
400 - Bad Request
The 400 Bad Request error is an HTTP status code that means that the request you sent to the website server was somehow incorrect or corrupted ((e.g., malformed request syntax, invalid request message framing, or deceptive request routing).) and the server couldn’t process it.
401 - Token is necessary
Current request requires user authentication. Your API key may be invalid, or you’ve attempted to access the wrong data center.
403 - Auth Denied
You are not permitted to access this resource.Check if user has the necessary permissions for the request.
404 - Resource Not Found
The HTTP 404 Not Found Error means that the webpage you were trying to reach could not be found on the server. It is a Client-side Error which means that either the page has been removed or that you typed in the URL incorrectly.
500 - Server error,Please contact your administrator
The 500 Internal Server Error is a very general HTTP status code that means something has gone wrong on the web site’s server but the server could not be more specific on what the exact problem is.
501 - Request uri not found
The requested URI resource could not be found. The server either does not recognize the request method or does not support the functionality required to fulfill the request.
502 Bad Gateway
The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.