Monthly Ads Metrics

Returns monthly ads metrics for the last 13 months, for the selected window and country. This is the data behind the Monthly Ads Metrics table. Returns one row per month, newest first.

Opportunities data is available from late July 2026. Earlier dates show no opportunities data.

Request

Method: GET
Endpoint: https://console.overwolf.com/api/stats/revenue-v2/monthly-ads-metrics

Query parameters

Name

Type

Description

app_idRequired

string

The UID of an app you have access to.

window_name

string

An app window name, or All Windows. Default: All Windows.

country

string

A country name as it appears in the dashboard Country filter. Default: All Countries.

Additional parameters

Name

Type

Description

AuthorizationRequired

header

string

Key <your-console-email>:<your-api-key>. For more information, see the Revenue APIs overview.

Response

The response is a JSON object with a columns array and a rows array. Each row has these fields:

Field	Description
`month`	The month.
`total_impressions`	Ads actually shown.
`Opportunities`	Times an ad slot was requested or available. Note the capital `O`.
`total_gross_revenue`	Gross ads revenue, in USD.
`total_net_revenue`	Net ads revenue, in USD.
`adjustments`	Revenue adjustments for the month, in USD.
`gross_cpm`	Gross revenue per 1,000 impressions, in USD.
`net_cpm`	Net revenue per 1,000 impressions, in USD.
`mau`	Monthly active users.
`arpmau_gross`	Gross revenue per monthly active user.
`arpmau`	Net revenue per monthly active user.
`window_name`	App window name, or `All Windows` for all windows combined.
`country_name`	Country name, or `All Countries` for all countries combined.
`country`	Country identifier for `country_name`.
`application_name`	App name.
`application_id`	Overwolf app identifier.
`app_id`	Your app UID.
`updated_at`	When the data was last updated.

200

Monthly Ads Metrics

Field	Type
`columns.name`	string
`columns.friendly_name`	string
`columns.type`	string
`rows.month`	string
`rows.total_impressions`	integer
`rows.Opportunities`	integer
`rows.total_gross_revenue`	number
`rows.total_net_revenue`	number
`rows.adjustments`	number
`rows.gross_cpm`	number
`rows.net_cpm`	number
`rows.mau`	integer
`rows.arpmau_gross`	number
`rows.arpmau`	number
`rows.window_name`	string
`rows.country_name`	string
`rows.country`	string
`rows.application_name`	string
`rows.application_id`	string
`rows.app_id`	string
`rows.updated_at`	string

Request

https://console.overwolf.com/api/stats/revenue-v2/monthly-ads-metrics?app_id=YOUR_APP_ID&window_name=All%20Windows&country=All%20Countries

Response

{
  "columns": [
    {
      "name": "month",
      "friendly_name": "month",
      "type": "date"
    },
    {
      "name": "total_impressions",
      "friendly_name": "total_impressions",
      "type": "integer"
    },
    {
      "name": "Opportunities",
      "friendly_name": "Opportunities",
      "type": "integer"
    },
    {
      "name": "total_gross_revenue",
      "friendly_name": "total_gross_revenue",
      "type": "float"
    },
    {
      "name": "total_net_revenue",
      "friendly_name": "total_net_revenue",
      "type": "float"
    },
    {
      "name": "adjustments",
      "friendly_name": "adjustments",
      "type": "float"
    },
    {
      "name": "gross_cpm",
      "friendly_name": "gross_cpm",
      "type": "float"
    },
    {
      "name": "net_cpm",
      "friendly_name": "net_cpm",
      "type": "float"
    },
    {
      "name": "mau",
      "friendly_name": "mau",
      "type": "integer"
    },
    {
      "name": "arpmau_gross",
      "friendly_name": "arpmau_gross",
      "type": "float"
    },
    {
      "name": "arpmau",
      "friendly_name": "arpmau",
      "type": "float"
    },
    {
      "name": "window_name",
      "friendly_name": "window_name",
      "type": "string"
    },
    {
      "name": "country_name",
      "friendly_name": "country_name",
      "type": "string"
    },
    {
      "name": "country",
      "friendly_name": "country",
      "type": "string"
    },
    {
      "name": "application_name",
      "friendly_name": "application_name",
      "type": "string"
    },
    {
      "name": "application_id",
      "friendly_name": "application_id",
      "type": "string"
    },
    {
      "name": "app_id",
      "friendly_name": "app_id",
      "type": "string"
    },
    {
      "name": "updated_at",
      "friendly_name": "updated_at",
      "type": "datetime"
    }
  ],
  "rows": [
    {
      "month": "YYYY-MM-DD",
      "total_impressions": 0,
      "Opportunities": 0,
      "total_gross_revenue": 0,
      "total_net_revenue": 0,
      "adjustments": 0,
      "gross_cpm": 0,
      "net_cpm": 0,
      "mau": 0,
      "arpmau_gross": 0,
      "arpmau": 0,
      "window_name": "All Windows",
      "country_name": "All Countries",
      "country": "<country>",
      "application_name": "<app name>",
      "application_id": "<application_id>",
      "app_id": "YOUR_APP_ID",
      "updated_at": "YYYY-MM-DDTHH:MM:SS"
    }
  ]
}