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

total_offers_num	1221
max_page	1
page	1
offers_num_this_page	1221
success	true
offers	[…]

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