POP 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 user
• us: Value of user-agent header of a user
• ref: Value of referrer header of a user
• xfw: Value of x-forwarded-for header of a user
• sid: Also called SubID. Source of the traffic were the user is coming from
• xrw: Value of x-requested-with header of a user
• lng: 2-letter ISO language code of a user
• sfd: Value of sec-fetch-dest header of a user
• 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","version":"24.0.0.0"}]

Optional:

• key: Keyword associated with the request

Bid Response:

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

Bid Request Template:

http://<AuctionDomain>/auction?id={id}&auth={auth}&ip={ip}&us={us}&ref={ref}&xfw={xfw}&sid={sid}&xrw={xrw}&lng={lng}&mod={mod}&mob={mob}&plt={plt}&pltv={pltv}&flv={flv}&key={key}

Example of Bid Request:

http://<AuctionDomain>/auction?id=12345&auth=testAuth&ip=127.0.0.1&us=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&sid=testSubId&ref=http%3A%2F%2Fgoogle.com%2F&lng=jp&key=best+deals&xfw=&xrw=&sfd=&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:

{
  "result":[
    {
      "cpc": 0.00012,
      "url": "https://domain.com/click"
    }
  ]
}

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
}