getOfferById
1.1.1 Summary
Get information detail of one offer by offer ID or by both offer ID and offer status combination. If you want to get multiple offers, you can type a string of ID s and use comma as delimiter.
1.1.2 Request
Request Method: GETParameters:
Parameter | Description | Type | Data Range |
key |
Network API Key; *Required |
string | |
id |
Offer ID *Required |
int |
You can request a string of ID s and use comma as a delimiter, For ex: 1,5,6 |
status |
Offer Status; Optional; Default: All |
string |
All, Archived, Active, Pending, Paused, Expired |
1.1.3 Response
Header:HTTP Status | Object | Description | Error Code |
200 | Request | Success | 0 |
400 |
Parameter: ID | No Offer ID | 6301 |
Parameter: ID | Invalid Offer ID | 6302 | |
Parameter: status | Invalid Value of Offer Status | 6303 |
Content Format: JSON.
Each offer is represented as a JSON code.
Variety of offers form an array of JSON.
Offer Property | Description |
id | Offer ID |
name | Offer Name |
status | Offer Status |
advertiser_id | Advertiser ID |
create_date | Offer Created Date (YYYY/MM/DD) |
expire_date | Offer Expire Date (YYYY/MM/DD) |
type | Offer Type |
categories | Offer Categories |
url | Offer URL |
preview_url | Offer Preview URL |
tracking_protocol | Conversion Tracking Protocol |
ssl | Using SSL Tracking or not |
conversion_point | Conversion Point |
currency | Offer Currency |
price_model | Price Model |
payout | Payout (CPA, CPC) |
revenue | Revenue (CPA, CPC) |
payout_percent | Payout Percent (CPS) |
revenue_percent | Revenue Percent (CPS) |
logo | Offer Logo Image Path |
screenshot | Offer Screen shot Image Path |
description | Offer Description |
restriction | Offer Restriction |
secondary_offer | Secondary Offer ID |
access_type | Offer Access Type |
session_lifespan | Offer Click Session Lifespan |
force_unique | Using Unique ID to Limit Conversion or not |
need_security_token | Using Security Token to Security Conversion or not |
enable_payout_tier | Using Tier Payout Settings or not |
tier_payout | Array Tier Payout |
has_cap_limit | Using CAP to Limit Conversion or not |
cap_range | Cap Range |
cap_type | CAP Type |
cap_overall_limit | Offer Overall CAP Limitation |
cap_interval | Interval CAP Type |
cap_interval_limit | Limitation for Interval CAP Type |
cap_affiliate_overall_limit | Affiliate Overall CAP Limitation of the Offer |
cap_affiliate_interval | Affiliate Interval CAP Type |
cap_affiliate_interval_limit | Limitation for Affiliate Interval CAP Type |
allow_traffics | Allows Traffics Array |
enable_geo_targeting | Using GEO Targeting or not |
geo_type | Include or Exclude |
geo_countries | Countries |
geo_states | States |
geo_enforce | Enforce GEO or not |
geo_redirect_offer | Geo Redirect Offer ID |
geo_redirect_group | GEO Redirect Offer Group ID |
enable_device_targeting | Using Device Targeting or not |
device_rules | Device Rules |
device_redirect_offer | Device Redirect Offer ID |
click_count | - |
last_click_time | - |
conversion_count | - |
last_conversion_time | - |
test_click_count | - |
last_test_click_time | - |
test_conversion_count | - |
last_test_conversion_time | - |
events | Array of Offer Events |
1.1.4 Example
Sample Request URL:http://{Your_Network_Domain}/api/v1/getOfferById?key=603E3F0E3266&id=12
Response sample:
{ "httpStatus": 200, "data": [ { "id": "12", "name": "testoffer12", "create_date": "2015/02/13", "expire_date": "2015/02/26", "status": "Active", "type": "Tablet", "url": "http://6.cn?tid={TID}", "preview_url": "http://6.cn", "tracking_protocol": "Image Pixel", "ssl": "No", "conversion_point": "", "currency": " United States, Dollars", "price_model": "CPA", "logo": "", "screenshot": "", "description": "", "restriction": "", "access_type": "Public", "session_lifespan": null, "hide_referrer":"Yes", "enable_geo_targeting": "Yes", "geo_type": "Include", "geo_countries": "CN;NP", "enable_device_targeting": "Yes", "categories": [ { "category_id": "1", "category_name": "Game" } ], "allow_traffics": [ { "traffic_id": 1, "traffic_name": "Banner" }, { "traffic_id": 2, "traffic_name": "Email" }, { "traffic_id": 3, "traffic_name": "Facebook" }, { "traffic_id": 4, "traffic_name": "Google" } ], "geo_states": [ "CN:1:53;54", "NP:0:3;1" ], "device_rules": [ "1:OS:iOS;Windows phone" ], "advertiser_id": "4", "payout": "8", "revenue": "9", "secondary_offer": "", "force_unique": "No", "need_security_token": "No", "enable_payout_tier": "Yes", "has_cap_limit": "Yes", "cap_type": "conversion", "cap_overall_limit": "100", "cap_interval": "Daily", "cap_interval_limit": "50", "cap_affiliate_overall_limit": "40", "cap_affiliate_interval": "Daily", "cap_affiliate_interval_limit": "20", "geo_enforce": "Enable", "geo_redirect_offer": "11", "geo_redirect_group": "", "device_redirect_offer": "11", "click_count": 0, "last_click_time": "", "conversion_count": 0, "last_conversion_time": "", "test_click_count": 0, "last_test_click_time": "", "test_conversion_count": 0, "last_test_conversion_time": 0, "tier_payout": [ { "tier_id": 1, "payout": "100" }, { "tier_id": 2, "payout": "200" }, { "tier_id": 3, "payout": "300" } ], "events": [ { "id": "294", "e_id": "1", "event_name": "InitialEvent", "e_tkn": "", "pre_event_id": "-1", "description": "", "status": "Active", "tracking_method": "iFrame Pixel", "is_end_point": "False", "revenue_type": "RPA", "payout_type": "CPA", "is_private": "False", "revenue": "7.000", "payout": "2.000", "can_multiply_conversion": "False", "need_approval": "No", "conversion_point": "PIN-Submit" } ] } ], "errorCode": 0, "message": "" } |
Close All
API V3
API V2
-
User - Network
-
User - Affiliate
-
Offer
-
Report
-
Dictionary
API V1 (DEPRECATED)