HugOffers API Documents
1. Introduction
This document will introduce HugOffers API (hereinafter referred to as API). Advanced partners can get campaign information by calling API .
HugOffers API is built on HTTP protocol, using GET / POST way to obtain the response content. Notably, to call our API, please contact with your account manager to get your API Key for authentication. Since anyone can conduct API request on your account’s behalf with the API Key, please keep your API Key confidential.
2. Get Campaign List
This interface will provide a list of promoted campaigns and all related information. The return value is a json.
Note:
This interface is case sensitive and you must distinguish campaigns by yourself.
2.1 Query Params:
Get
POST
http://{cid}.hoapi0.com/v1?cid={Customer_id}&token={Token}
Please contact your account manager to get your unique request URL.
Path Parameters
2.2 Response
2.3 Offer Data
Note1:
You may not receive the following four parameters, “min_android_version”,
“max_android_version”, “min_ios_version” and “max_ios_version”, at the same time. If “platform” is Android, you will only receive “min_android_version” and “max_android_version”. Otherwise, you will only receive “min_ios_version” and “max_ios_version”.
Note2:
“campid” is our campaign’s unique index. Our “tracking_link” may be changed, due to the server migration. So if you use “tracking_link” to match campaign information requested by API to which you’ve received from us before, please refer to the below string, part of “tracking_link”, which does not change during campaign’s life time.
354634 remains the same during campaign’s flight time.
e.g.:
https://{cid}.hotrk0.com/offer?offer_id=354634&aff_id=91&aff_sub=[click_id]&aff_pub=[source]&advertising_id=[advertising_id]&idfa=[idfa]
2.3 example
{
total_offers_num: 1,
max_page: 1,
page: 1,
offers_num_this_page: 1,
success: true,
offers: [
{
campid: "354634",
offer_name: "tap4fun_Spartanwars_ru",
status: "running",
platform: "Android",
tracking_link:"https://{cid}.hotrk0.com/offer?offer_id=354634&aff_id=91&aff_sub=[click_id]&aff_pub=[source]&advertising_id=[advertising_id]",
geo: "MY",
preview_link:"https://play.google.com/store/apps/details?id=com.tap4fun.spartanwar", price: 1,
price_model: "cpi",
app_category: "Game",
start_time: "1553498486",
start_date: "2019-03-25T07:21:26+0000",
end_time: "1585034486",
end_date: "2020-03-24T07:21:26+0000",
update_time: "1553502101",
update_date: "2019-03-25T08:21:41+0000",
effective_time: "1553498486",
effective_date: "2019-03-25T07:21:26+0000",
exclude_device: "",
exclude_site: "0",
carriers: "",
daily_cap: 100,
icon_link: "https://lh3.googleusercontent.com/rZkpGk1TcmElfKXLC_NZldKGW8rPPngTuTfmJ 9Z7SfF_Qy6vN1u4Ymy3JzNIQ9e9ZqN3=w300",
creatives_link: [{"url":"http://hugoffers.com/1.jpg","width":1200,"height":627},
{"url":"http://test.hugoffers.com/2.jpg","width":640,"height":100}]
video_link:[ {"url":"http://testhugoffers.com/4.mp4","duration":30,"width":1200,"height":627},{"url":"http://testhugoffers.com/5.jpg","duration":15,"width":640,"height":100}]
app_name: "",
app_desc: "",
app_size: "0",
app_rate: "0",
app_id: "com.tap4fun.spartanwar",
min_android_version: "",
max_android_version: "",
min_ios_version:"5.0",
max_ios_version:"",
requirement_traffic:"non-incent",
performance_criteria:"kpi details",
white_source:"",
black_source:"",
Impression_link:""
}
]
}
3.Tracking Parameters
4.Postback format
Last updated