GET /offerStats (advertiser)  API documentation

Get the same data available in the Offer reports (advertiser revenues by date, country, offer or user_id)

GET https://demo.trafficmanager.com/api/v1.2/offerStats/{startTime}/{endTime}/

Authentication:

The request must be authenticated with the following HTTP headers:

• x-api-key: Your API key, found in the Security page
• x-user-id: Your User ID, found in the Security page

GET Parameters:

• Required:
• startTime: Start time. Unix timestamp or any value accepted by strtotime. For example: 2023-01-01, today, -10 minutes...
• endTime: End time. Unix timestamp or any value accepted by strtotime. For example: 2023-01-01 23:59:59, today 23:59:59, -5 minutes...
• Optional:
• user_id: This parameter is available only if authenticated as an admin. If set, data will be fetched for the user with that ID.
• groupBy (default: offer): comma-separated list that can contain the following values: date,offer,user,landingpage (no space allowed)
  
• offer_id: offer ID filter (if set, returns only the data for that offer)
• cc: country filter (two-letter country code), if set, returns only the data for that country.
• timezone: timezone. Valid values are listed here: Timezones. If not set, the network default timezone (UTC) will be used.

Returned values:

• Each row will contain these fields.
  If a group (for example utm_content or offer) is not added to the groupBy parameter, it will be an empty string.
• Date
• Offer ID and name (format: "#id - name")
• utm_source
• utm_medium
• utm_campaign
• utm_term
• utm_content
• Number of impressions
• Number of clicks
• Number of unique clicks
• Number of leads
• Number of conversions
• Metric 1 (CR (%))
• Metric 2 (Cost/click)
• Metric 3 (Cost/uq. click)
• Total payout to the affiliate

Request example

GET https://demo.trafficmanager.com/api/v1.2/offerStats/yesterday/yesterday/?groupBy=offer

Response example

{
  "data": [
    [
     "2026-01-06 - 2026-01-06",
     "#830 - Private offer - Exclusive offer XYZ",
     "",
     "",
     "",
     "",
     "",
     51349,
     4672,
     1354,
     28,
     "0.00",
     "-%",
     "-100.0%",
     "33.32"
    ],
    [
      "2026-01-06 - 2026-01-06",
      "#542 - Special offer ABC",
      "",
      "",
      "",
      "",
      "",
      2474900, 202941, 40588, 1014, "0.00",
      "-%",
      "-100.0%",
      "253.50"
    ]
  ],
  "i": 13658989,
  "grp": {
    "hour": 0,
    "date": 0,
    "month": 0,
    "offer": 1,
    "utm_source": 0,
    "utm_medium": 0,
    "utm_campaign": 0,
    "utm_term": 0,
    "utm_content": 0,
    "event": 0
  },
  "status": 200
}
    

---

Request example

GET https://demo.trafficmanager.com/api/v1.2/offerStats/yesterday/yesterday/?groupBy=date,offer,utm_source

Response example

{
   "data":[
      [
         "2026-01-06",
         "#830 - Private offer - Exclusive offer XYZ",
         "source_8",
         "",
         "",
         "",
         "",
         75049,
         4352,
         870,
         65,
         "0.00",
         "-%",
         "-100.0%",
         "17.55"
      ],
      [
         "2026-01-06",
         "#830 - Private offer - Exclusive offer XYZ",
         "source_6",
         "",
         "",
         "",
         "",
         1036300,
         25907,
         10880,
         233,
         "0.00",
         "-%",
         "-100.0%",
         "300.57"
      ]
   ],
   "i":19360231,
   "grp":{
      "hour":0,
      "date":1,
      "month":0,
      "offer":1,
      "utm_source":1,
      "utm_medium":0,
      "utm_campaign":0,
      "utm_term":0,
      "utm_content":0,
      "event":0
   },
   "status":200
}