API Docs v2025.1

offer api

https://offers.suncentads.com/v2/offers?token=XXX&app_id=000

Param

param name type desc
app_id string Publisher ID / Developer ID
token string Token

API Response

field name type desc
offers array offer details
code int Code:
0: Success
1001: Param Error

Offer Detail

field name type desc
id string offer id
name string offer name
pkg_name string package name
description string offer’s desc
icon string app’s icon url
payout_model string CPI/CPE
target_conversion string Install/Event
target_cap int conversion cap
payout string price
currency string USD
daily_cap string daily cap ; 0 means open cap
click_cap string daily click cap ; 0 means open cap
hour_click_cap string hourly click cap
kpi string kpi
preview_link string Appstore URL
tracking_link string Tracking Link
targeting object targeting
- geo array allow countries, [IN,ID]
- geo_exclude array not allow countries, [IN,ID]
- os string os, "android" or "ios"
- os_vers string os version
- event_types array event_types
{
    "code": 0,
    "offers": [
            "id": "134236",
            "name": "Flights, railways, hotels",
            "pkg_name": "ru.tutu.tutu_emp",
            "description": "Flights, railways, hotels",
            "icon": "https://play-lh.googleusercontent.com/Xn8NHefqmDnnfjUuO6XdxcNurEsg6o4JDHhp0pWkHqBj0GnrPbVXjhbT4B8UTi9Tie0W",
            "payout_model": "CPI",
            "target_conversion": "Install",
            "target_cap": 800,
            "payout": 0.864,
            "currency": "USD",
            "daily_cap": 800,
            "click_cap": 0,
            "hour_click_cap": 0,
            "kpi": "",
            "preview_link": "https://play.google.com/store/apps/details?id=ru.tutu.tutu_emp",
            "tracking_link": "https://click.suncentads.com/clk?offerId=134236&pubId=000",
            "targeting": {
                "geo": [
                    "RU"
                ],
                "geo_exclude": [],
                "os": "android",
                "os_vers": "",
                "event_types": []
            }
        }
    ]
}

Offer Tracking URL

The click URL tracking_link (json interface returns) :

https://click.suncentads.com/clk?offerId=8656&pubId=000

You can add more parameters for tracking purposes. The click URL includes several parameters that need to be replaced with the appropriate macros:

Eg: https://click.suncentads.com/clk?offerId=8656&pubId=000&aff_sub={your_click_id}&sub_id={your_sub_id}&gaid={gaid}&idfa={idfa}

Parameter type Description
offerId int offer id
pubId int pub id
aff_sub string your clickid
sub_id string your sub channel
gaid string google advertising id
idfa string user idfa parameter for ios devices
idfv string idfv