Statistics API

Endpoint

GET https://code.21wiz.com/api/web2.php

Parameters (GET)

Parameter	Required	Format	Default	Description
`dateStart`	no	`YYYY-MM-DD`	today	Period start, inclusive
`dateEnd`	no	`YYYY-MM-DD`	today	Period end, inclusive
`key`	no	string	—	Filter by a specific placement. If omitted, all placements in the account are returned.
`groupBy`	no	comma-separated list	`country,domain,platform,origin`	Additional levels after date and placement. Their order defines nesting. Pass `groupBy=` for totals without breakdown.

Groupings

Base levels date → placement are always present. Additional levels appear in the order supplied in groupBy; metrics are placed at the deepest level.

Value	Description	Possible values
`country`	Impression country	Country ISO code (`RU`, `AZ`, …) or `undefined`
`domain`	Site URL or identifier	Account value or `undefined`
`platform`	Device type	`desktop`, `mobile:smart`, `tablet`, `undefined`
`origin`	Source domain detected by the system or received through RTB	Domain or `undefined`

Response

Content-Type: application/json

Default: groupBy=country,domain,platform,origin

{
  "status": "success",
  "code": 200,
  "data": {
    "2026-05-26": {
      "1224a281e3bee0e5eec0b9e3f047b38b": {
        "RU": {
          "example.com": {
            "desktop": {
              "origin-example.com": { "imps": 264, "clicks": 3, "revenue": 17.17 }
            },
            "mobile:smart": {
              "origin-example.com": { "imps": 302, "clicks": 12, "revenue": 19.63 }
            },
            "tablet": {
              "undefined": { "imps": 8, "clicks": 0, "revenue": 0.52 }
            }
          }
        },
        "AZ": {
          "example.com": {
            "desktop": {
              "origin-example.com": { "imps": 4, "clicks": 0, "revenue": 0.26 }
            }
          }
        }
      }
    }
  }
}

groupBy=country — country only

{
  "status": "success",
  "code": 200,
  "data": {
    "2026-05-26": {
      "1224a281e3bee0e5eec0b9e3f047b38b": {
        "RU": { "imps": 596, "clicks": 16, "revenue": 38.74 },
        "AZ": { "imps": 4, "clicks": 0, "revenue": 0.26 }
      }
    }
  }
}

groupBy= — no additional grouping

{
  "status": "success",
  "code": 200,
  "data": {
    "2026-05-26": {
      "1224a281e3bee0e5eec0b9e3f047b38b": { "imps": 600, "clicks": 16, "revenue": 39.00 },
      "bc5950df574f62ba2304131587a5aa13": { "imps": 59, "clicks": 1, "revenue": 3.84 }
    }
  }
}

Metric fields

Field	Type	Description
`imps`	int	Impressions
`clicks`	int	Clicks
`revenue`	float	Revenue, rounded to two decimal places

Examples

All placements for one day with the full default breakdown

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/web2.php?dateStart=2026-05-26&dateEnd=2026-05-26"

Country breakdown for one week

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/web2.php?dateStart=2026-05-20&dateEnd=2026-05-26&groupBy=country"

Specific placement grouped by platform, country and origin

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/web2.php?dateStart=2026-05-26&dateEnd=2026-05-26&key=1224a281e3bee0e5eec0b9e3f047b38b&groupBy=platform,country,origin"

Placement totals without a breakdown

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/web2.php?dateStart=2026-05-26&dateEnd=2026-05-26&groupBy="

Endpoint

GET https://code.21wiz.com/api/adv2.php

Parameters (GET)

Parameter	Required	Format	Default	Description
`dateStart`	no	`YYYY-MM-DD`	today	Period start, inclusive
`dateEnd`	no	`YYYY-MM-DD`	today	Period end, inclusive
`groupBy`	no	comma-separated list	`origin`	Additional grouping after date and creative. Allowed: `origin`. Pass `groupBy=` for creative totals.

Groupings

Base levels date → creative ID are always present. origin adds the traffic source domain as the deepest level; an empty value is returned as undefined.

Response

Default response with groupBy=origin

{
  "status": "success",
  "code": 200,
  "data": {
    "2026-05-26": {
      "12345": {
        "source.example": { "imps": 600, "clicks": 16, "spend": 39.00 },
        "undefined": { "imps": 8, "clicks": 0, "spend": 0.52 }
      }
    }
  }
}

Response with groupBy=

{
  "status": "success",
  "code": 200,
  "data": {
    "2026-05-26": {
      "12345": { "imps": 608, "clicks": 16, "spend": 39.52 }
    }
  }
}

Metric fields

Field	Type	Description
`imps`	int	Impressions
`clicks`	int	Clicks
`spend`	float	Spend, rounded to two decimal places

Examples

Statistics grouped by origin

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/adv2.php?dateStart=2026-05-20&dateEnd=2026-05-26"

Creative totals without origin

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://code.21wiz.com/api/adv2.php?dateStart=2026-05-20&dateEnd=2026-05-26&groupBy="

HTTP	Body	When
`200`	`{"status":"success","data":{...},"code":200}`	Data is available
`200`	`{"status":"success","message":"No data","code":404}`	No data for the period
`200`	`{"status":"error","message":"Wrong dates!","code":2}`	Invalid dates
`200`	`{"status":"error","message":"Invalid groupBy value: ...","code":3}`	Unsupported grouping
`401`	`{"status":"error","message":"Unauthorized","code":401}`	Missing or invalid Bearer token

Endpoint

Parameters (GET)

Groupings

Response

Metric fields

Examples

Endpoint

Parameters (GET)

Groupings

Response

Metric fields

Examples

Authorization

Possible responses