Ads Revenue - Year over Year

Returns monthly ads revenue for the last 13 months, each compared with the same month a year earlier, for the selected country. This is the data behind the Ads Revenue - Year over Year chart, which shows gross revenue. Returns one row per month.

The response has both gross and net values.

Request

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

Query parameters

Name

Type

Description

app_idRequired

string

The UID of an app you have access to.

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.
`first_seg_rev_gross`	Gross ads revenue in `month`, in USD. The dashboard labels this series Current Year.
`second_seg_rev_gross`	Gross ads revenue in the same month a year earlier, in USD. The dashboard labels this series Previous Year.
`first_series_net_revenue`	Net ads revenue in `month`, in USD.
`second_series_net_revenue`	Net ads revenue in the same month a year earlier, in USD.
`country_name`	Country name, or `All Countries` for all countries combined.
`country`	Country identifier for `country_name`.
`app_id`	Your app UID.
`updated_at`	When the data was last updated.

200

Ads Revenue - Year over Year

Field	Type
`columns.name`	string
`columns.friendly_name`	string
`columns.type`	string
`rows.month`	string
`rows.first_seg_rev_gross`	number
`rows.second_seg_rev_gross`	number
`rows.first_series_net_revenue`	number
`rows.second_series_net_revenue`	number
`rows.country_name`	string
`rows.country`	string
`rows.app_id`	string
`rows.updated_at`	string

Request

https://console.overwolf.com/api/stats/revenue-v2/ads-revenue-year-over-year?app_id=YOUR_APP_ID&country=All%20Countries

Response

{
  "columns": [
    {
      "name": "month",
      "friendly_name": "month",
      "type": "date"
    },
    {
      "name": "first_seg_rev_gross",
      "friendly_name": "first_seg_rev_gross",
      "type": "float"
    },
    {
      "name": "second_seg_rev_gross",
      "friendly_name": "second_seg_rev_gross",
      "type": "float"
    },
    {
      "name": "first_series_net_revenue",
      "friendly_name": "first_series_net_revenue",
      "type": "float"
    },
    {
      "name": "second_series_net_revenue",
      "friendly_name": "second_series_net_revenue",
      "type": "float"
    },
    {
      "name": "country_name",
      "friendly_name": "country_name",
      "type": "string"
    },
    {
      "name": "country",
      "friendly_name": "country",
      "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",
      "first_seg_rev_gross": 0,
      "second_seg_rev_gross": 0,
      "first_series_net_revenue": 0,
      "second_series_net_revenue": 0,
      "country_name": "All Countries",
      "country": "<country>",
      "app_id": "YOUR_APP_ID",
      "updated_at": "YYYY-MM-DDTHH:MM:SS"
    }
  ]
}