Get XML statistics

GET /xml/stats

Returns XML traffic statistics for one owned TID.

Query parameters

Parameter	Required	Description
token	Yes	Publisher API key with publisher:xml:read.
tid	Yes	Positive XML traffic-source/account identifier.
date_from	Yes	Inclusive start date in YYYY-MM-DD.
date_to	Yes	Inclusive end date in YYYY-MM-DD.
groupBy	No	day, geo, or subid; default day.
export	No	json or csv.

By day

curl --get "https://api.example.com/xml/stats" \
  --data-urlencode "token=YOUR_NEXUS_API_KEY" \
  --data-urlencode "tid=12345" \
  --data-urlencode "date_from=2026-08-01" \
  --data-urlencode "date_to=2026-08-17" \
  --data-urlencode "groupBy=day"

By country

curl --get "https://api.example.com/xml/stats" \
  --data-urlencode "token=YOUR_NEXUS_API_KEY" \
  --data-urlencode "tid=12345" \
  --data-urlencode "date_from=2026-08-01" \
  --data-urlencode "date_to=2026-08-17" \
  --data-urlencode "groupBy=geo"

By SubID

curl --get "https://api.example.com/xml/stats" \
  --data-urlencode "token=YOUR_NEXUS_API_KEY" \
  --data-urlencode "tid=12345" \
  --data-urlencode "date_from=2026-08-01" \
  --data-urlencode "date_to=2026-08-17" \
  --data-urlencode "groupBy=subid"

Example daily response

{
  "status": "success",
  "message": "XML API report",
  "data": [
    {
      "date": "2026-08-17",
      "gross_requests": 26023392,
      "gross_clicks": 10356,
      "gross_valid": 10356,
      "gross_invalid": 0,
      "gross_revenue": 5.28,
      "net_requests": 0,
      "net_clicks": 3749,
      "net_revenue": 2.25
    }
  ]
}

Errors

• 403 — the TID is invalid, foreign, or forbidden for this key.
• 404 — no data was available for the requested export.
• 422 — invalid dates, grouping, export format, or numeric input.