Suncent Ads

Offers API Documentation v2.0

Offers API

Use the following endpoint to fetch available offers. You must provide a valid app_id and token.

Request Parameters

Parameter Name	Type	Description
app_id	string	Channel ID / App ID provided by Suncent Ads
token	string	Authentication token corresponding to the app_id

Response Fields

Field Name	Type	Description
offers	array	A list of available offer details
code	int	Response code. 0: Success, 1001: Parameter Error

Offer Detail Object

Field Name	Type	Description
id	string	Unique Offer ID
name	string	The name of the offer
pkg_name	string	Package name / Bundle ID
description	string	Description of the offer
icon	string	URL to the application's icon
payout_model	string	Pricing model (e.g., CPI)
ad_type	string	"website" or "app"
payout	string	Payout amount per conversion
currency	string	Currency code (e.g., "USD")
daily_cap	string	Daily conversion limit; empty string means unlimited
kpi	string	Performance metrics (KPI) details
preview_link	string	Google Play or App Store link for preview
tracking_link	string	The tracking URL for promotion
black_channel	string	Blacklisted channels (comma-separated)
white_channel	string	Whitelisted channels (comma-separated)
creatives	object	Reserved field for creative assets
targeting	object	Targeting criteria
- geo	array	Included countries (e.g., [IN, ID]). "Global" means all countries.
- geo_exclude	array	Excluded countries
- os	string	Target OS: "android" or "ios"
- os_vers	string	Minimum required OS version

Tracking URL

Tracking URL: http(s)://xxx.xxx.xxx/clk?offer_id=0&affid=0&...

Parameter	type	Description
aff_sub	string	your clickid
sub_id	string	sub channel
gaid	string	google advertising id
idfa	string	user idfa parameter for ios devices
ip	string	user ip
ua	string	user-agent
os_version	string	os version
device_model	string	device model

Postback URL

You can contact your account manager to set up the global postback:

Example: http(s)://xxx.xxx.xxx?clickid={aff_sub}

Macro we support:

param
{aff_sub}
{payout}