Offer
Request URL
https://macan-native.com/api/v1/getOffers?code={code}
Request Method
GET
Accept-Encoding: gzip, deflate
Request Format
| Key | Type | Require | Description |
|---|---|---|---|
| code | String | TRUE | Affiliate token |
| ids | String | FALSE | List of offer ids (e.g. 123, 456) |
| names | String | FALSE | List of offer names (e.g. abc, def) |
| pkgs | String | FALSE | List of product names (e.g. pkg1, pkg2) |
| countries | String | FALSE | Target countries (e.g. IN, ID) |
| platforms | String | FALSE | Target platforms (e.g. , ) |
| page | Integer | FALSE | Default page is 1 |
| size | Integer | FALSE | Default size is 500, less than 5000 |
Response
| Key | Type | Description |
|---|---|---|
| records | Array<Object> | Affiliate offers with relevant details |
| current | Integer | The current page number in the pagination |
| size | Integer | The number of items per page in the pagination |
| total | Integer | The total number of items available in the pagination |
| pages | Integer | The total number of pages available in the pagination |
Offer Object
| Key | Type | Description |
|---|---|---|
| campaign_id | String | The ID of the campaign |
| campaign_name | String | The name of the campaign |
| package_name | String | The name of the app package |
| tracking_link | String | The tracking link for the offer |
| impression_link | String | The impression link for the offer |
| preview_link | String | The preview link for the app |
| icon | String | The URL of the app icon |
| cap_daily | Integer | The maximum number of daily conversions allowed for the offer |
| click_daily | Integer | The maximum number of daily clicks allowed for the offer 0 means ♾️ |
| payout | Float | The payout amount for the offer |
| payout_type | String | The payout type for the offer |
| platform | String | The platform for the app |
| countries | List<String> | The list of countries where the offer is available |
| creatives | Array<Object> | The list of creatives for the offer |
| events | Array<Object> | The list of events and their associated payouts for the offer |
| currency | String | The currency for the payout |
| offer_description | String | The description of the offer |
Creative Object
| Key | Type | Description |
|---|---|---|
| id | String | The ID of the creative |
| name | String | The name of the creative |
| width | Integer | The width of the creative |
| height | Integer | The height of the creative |
| format | String | The format of the creative (e.g. JPG, GIF, PNG) |
Example
{
"records": [
{
"campaign_id": "xxxxxx",
"campaign_name": "Bravo Classic Slots-777 Casino CPE LV800 [US]",
"package_name": "vegas.classic.slots.bravo.free.android",
"tracking_link": "https://macan-native.com/ads/redirect?id=xxxxxx&userid=abc",
"impression_link": "",
"preview_link": "https://play.google.com/store/apps/details?id=vegas.classic.slots.bravo.free.android&gl=US",
"icon": "https://play-lh.googleusercontent.com/7CpsL2SIpYi-9ekWmuaZ-Jt7kurRctCBL474aFypaBfNBW5SdgauB8D7DzE7BEm611Q=s96-rw",
"cap_daily": 50,
"click_daily": 0,
"payout": 70.0,
"payout_type": "CPA",
"platform": "android",
"countries": [
"US"
],
"creatives": [],
"events": [
{
"LV800": 38.0,
"purchase": 20.0
}
],
"currency": "USD",
"offer_description": ""
},
{
"campaign_id": "xxxxxx",
"campaign_name": "WinningSlots_US_AOS",
"package_name": "slots.machine.winning.android",
"tracking_link": "https://macan-native.com/ads/redirect?id=xxxxxx&userid=abc",
"impression_link": "",
"preview_link": "https://play.google.com/store/apps/details?id=slots.machine.winning.android&hl=en_US&gl=US",
"icon": "https://play-lh.googleusercontent.com/iCHurxC5AzNGYIIJZixHSy6-Z0MVjWcTz5QM0gqpmPokyWty7OlcoHQXK_cwajCOvr4=s96-rw",
"cap_daily": 50,
"click_daily": 0,
"payout": 75.0,
"payout_type": "CPA",
"platform": "android",
"countries": [
"US"
],
"creatives": [],
"events": [
{
"lv1200": 25.0,
"purchase4.99": 6.0
}
],
"currency": "USD",
"offer_description": "flow:install-register-play a game-level up 1200"
},
{
"campaign_id": "xxxxxx",
"campaign_name": "Clubillion_US_AOS_LV1200",
"package_name": "clubillion.social.slots.casino.friends.free.android",
"tracking_link": "https://macan-native.com/ads/redirect?id=xxxxxx&userid=abc",
"impression_link": "",
"preview_link": "https://play.google.com/store/apps/details?id=clubillion.social.slots.casino.friends.free.android&hl=en_US&gl=US",
"icon": "https://play-lh.googleusercontent.com/64qmIYOye43CiDlriOoMkSEWMZXtygt2Vsj3ZrdyO2jrYTU2ZenMu_9OZB1ZHTBGjlE=s96-rw",
"cap_daily": 50,
"click_daily": 0,
"payout": 75.0,
"payout_type": "CPA",
"platform": "android",
"countries": [
"US"
],
"creatives": [],
"events": [
{
"lv1200": 25.0,
"purchase4.99": 6.0
}
],
"currency": "USD",
"offer_description": "flow:install-register-play a game-level up 1200"
}
],
"total": 3,
"size": 10,
"current": 1,
"orders": [],
"optimizeCountSql": true,
"searchCount": true,
"maxLimit": null,
"countId": null,
"pages": 1
}
Click Column
| Column | Description |
|---|---|
| sid | click id |
| gid | channel |
| devad_id | GAID(Google Advertising ID) or IDFA(Apple Identifier) |
| ip | click ip |
| ua | User-Agent |
| lang | language |
| os | os |
| osv | os version |
| model | device model |
| sub1 | sub1 |
| sub2 | sub2 |
Example
https://macan-native.com/ads/redirect?id=xxxxxx&userid=abc&sid=[your clickid]&gid=[your channel]&devad_id=[your devad_id]
Postback Column
| Column | Description |
|---|---|
| [sid] | click id |
| [gid] | affiliates channel |
| [devad_id] | GAID(Google Advertising ID) or IDFA(Apple Identifier) |
| [package_name] | offer package name |
| [trackingId] | offer id |
| [event_name] | event name |
| [payout] | offer price |
| [callback_timestamp] | callback time |
| [country] | country |
| [sub1] | sub1 |
| [sub2] | sub2 |
Example
http://[your domain]?your_clickid=[sid]&your_channel=[gid]