PUSH Integration

  • Our servers are located in Washington D. C.
  • The max response timeout is 200ms but it can be changed if it is required

Bid Request

Domain:

  • <auctiondomain>

Parameters (all parameters must be URL encoded):

Mandatory:
  • id: Feed id generated by <networkname>
  • auth: Feed Authorization code generated by <networkname>
  • ip: IP address of a subscriber
  • useragent: Url-encoded user agent of a subscriber
  • pub_id1: Also called SubID. Source of the traffic were the subscriber is coming from
  • mod: Value of sec-ch-ua-model header, e.g.: Redmi Note 9 Pro
  • mob: Value of sec-ch-ua-mobile header, e.g.: true, false, ?0, ?1
  • plt: Value of sec-ch-ua-platform header, e.g.: Android, macOS, Windows
  • pltv: Value of ch-ua-platform-version header, e. g.: 10.0.0
  • fvl: Value of sec-ch-ua-full-version-list header. We support 2 formats, exactly as the header value or as JSON, e. g.:
    • As header value: 
      "Google Chrome";v="107.0.5304.105", 
"Chromium";v="107.0.5304.105", "Not 
A;Brand";v="24.0.0.0"
    • As JSON: 
      [{"brand":"Google 
Chrome","version":"107.0.5304.105"},{"brand":"Chromium",
 "version":"107.0.5304.105"},{"brand":"Not=A?Brand","vers
 ion":"24.0.0.0"}]
Optional:
  • subscriber_id: Unique id of a subscriber
  • subscription_timestamp: Subscriber subscription timestamp. IMPORTANT: do not use subscription_date or subscription_days if you set this value!
  • subscription_date: Subscriber subscription date, example format: YYYY-MM-DD. IMPORTANT: do not use subscription_timestamp or subscription_days if you set this value!
  • subscription_days: Subscriber subscription days. IMPORTANT: do not use subscription_timestamp or subscription_date if you set this value!
  • language: 2-letter ISO language code of a subscriber
  • visit_postback: The URL that will be called after a visit on the returned offer. You should only send 'visit_postback' OR 'visit_postback_token', not both
  • visit_postback_token: The token for the postback URL. You should only send 'visit_postback' OR 'visit_postback_token', not both
  • xfw: x-forwarded-for header of a subscriber
  • xrw: x-requested-with header of a subscriber
  • sfd: sec-fetch-dest header of a subscriber

Bid Response:

  • Bid - HTTP 200
  • No Bid - HTTP 204
  • Error - HTTP 400

Bid Request Template:

http://<AuctionDomain>/auction?id={id}&auth={auth}&ip={ip}&useragent={useragent}&pub_id1={pub_id1}&mod={mod}&mob={mob}&plt={plt}&pltv={pltv}&flv={flv}&subscriber_id={subscriber_id}&subscription_timestamp={subscription_timestamp}&language={language}&visit_postback={visit_postback}&xfw={xfw}&xrw={xrw}&sfd={sfd}

Example of Bid Request:

http://<AuctionDomain>/auction?id=12345&auth=testAuth&ip=127.0.0.1&useragent=Mozilla%2F5.0%20%28Linux%3B%20Android%2010%3B%20vivo%201804%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F107.0.0.0%20Mobile%20Safari%2F537.36&pub_id1=54321&subscriber_id=123456789&subscription_timestamp=1725230002&language=jp&mod=SMA528B&plt=Android&pltv=12.0.0&mob=true&fvl=%5B%7B%22brand%22%3A%22Google%20Chrome%22%2C%22version%22%3A%22107.0.5304.105%22%7D%2C%7B%22brand%22%3A%22Chromium%22%2C%22version%22%3A%22107.0.5304.105%22%7D%2C%7B%22brand%22%3A%22Not%3DA%3FBrand%22%2C%22version%22%3A%2224.0.0.0%22%7D%5D

Example of Bid Response:

{
 "notifications": [
    {
        "title": "string",
        "body": "string",
        "url": "string",
        "icon_url": "string",
        "image_url": "string",
        "creative_id": "string",
        "payout_model": "CPC",
        "payout": 0.00012
    }
 ]
}

Statistics Report

Statistics Report Request:

Required http basic auth with your credentials in request

https://<platformdomain>/external/supply/statisticsapi/{AGGREGATION}?feedId={FEED_ID}&from=YYYY-MM-DD&to=YYYY-MM-DD

Parameters (All parameters must be URL encoded):

Allowed aggregations:
  • day (available last 60 days, maximum range of 60 days)
  • hour (available last 7 days, maximum range of 1 day)
  • subid (available last 60 days, maximum range of 1 day)
Required filters (query params)
  • feedId
  • from (yyyy-mm-dd format)
  • to (yyyy-mm-dd format)

Statistics Report Response:

  • aggregation
  • auctions
  • bids
  • impressions
  • visits
  • estimatedRevenue
  • revenue

DAY - Example Response:

{
 "data": [
    {
        "aggregation": "2025-07-11",
        "auctions": 132404830,
        "bids": 176333,
        "visits": 1604,
        "estimatedRevenue": 1.1962599213,
        "revenue": 1.1962599213
    }
 ],
 "error": null
}

HOUR - Example Response:

{
 "data": [
    {
        "aggregation": "2025-07-11 03:00:00",
        "auctions": 10699420,
        "bids": 10437,
        "visits": 19,
        "estimatedRevenue": 0.0071650565,
        "revenue": 0.0071650565
    }
 ],
 "error": null
}

SUBID - Example Response:

{
 "data": [
    {
        "aggregation": "subidTest",
        "auctions": 199013,
        "bids": 107,
        "visits": 1,
        "estimatedRevenue": 0.000903168,
        "revenue": 0.000903168
    }
 ],
 "error": null
}