Daily Ad Inventory & Fill Rate

Returns daily ad opportunities (times an ad could be shown), impressions (ads actually shown), and fill rate, for the selected window and country. This is the data behind the Daily Ad Inventory & Fill Rate chart. Returns one row per day.

This endpoint's country filter is country_name, not country. Its default window is desktop. To get all windows combined, set window_name to All Windows.

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/daily-ad-inventory-fill-rate

Query parameters

Name

Type

Description

app_idRequired

string

The UID of an app you have access to.

days_back

string

The period to return. Default: Last 90 Days.

Allowed values: Last 30 Days, Last 90 Days

window_name

string

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

country_name

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
`revenue_date`	The date.
`sum_impressions`	Ads actually shown.
`Opportunities`	Times an ad slot was requested or available. Note the capital `O`.
`fill_rate`	Impressions divided by opportunities, as a percentage from 0 to 100.
`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`.
`app_id`	Your app UID.
`updated_at`	When the data was last updated.

200

Daily Ad Inventory & Fill Rate

Field	Type
`columns.name`	string
`columns.friendly_name`	string
`columns.type`	string
`rows.revenue_date`	string
`rows.sum_impressions`	integer
`rows.Opportunities`	integer
`rows.fill_rate`	number
`rows.window_name`	string
`rows.country_name`	string
`rows.country`	string
`rows.app_id`	string
`rows.updated_at`	string

Request

https://console.overwolf.com/api/stats/revenue-v2/daily-ad-inventory-fill-rate?app_id=YOUR_APP_ID&days_back=Last%2090%20Days&window_name=desktop&country_name=All%20Countries

Response

{
  "columns": [
    {
      "name": "revenue_date",
      "friendly_name": "revenue_date",
      "type": "date"
    },
    {
      "name": "sum_impressions",
      "friendly_name": "sum_impressions",
      "type": "integer"
    },
    {
      "name": "Opportunities",
      "friendly_name": "Opportunities",
      "type": "integer"
    },
    {
      "name": "fill_rate",
      "friendly_name": "fill_rate",
      "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": "app_id",
      "friendly_name": "app_id",
      "type": "string"
    },
    {
      "name": "updated_at",
      "friendly_name": "updated_at",
      "type": "datetime"
    }
  ],
  "rows": [
    {
      "revenue_date": "YYYY-MM-DD",
      "sum_impressions": 0,
      "Opportunities": 0,
      "fill_rate": 0,
      "window_name": "All Windows",
      "country_name": "All Countries",
      "country": "<country>",
      "app_id": "YOUR_APP_ID",
      "updated_at": "YYYY-MM-DDTHH:MM:SS"
    }
  ]
}