Reporting Metrics

Pull an ad revenue report

Columns of a row by group_by, besides date (absent with granularity=totals-daily) and the requested metrics. A combination has the columns of each of its values.

group_by	Columns
app	app_id, app_name, app_icon_url, platform, bundle_id, store_id
channel	ad_network_id, ad_network_name, ad_network_icon_url, ad_network_short_id, ad_network_custom
country	country_name (the ISO country code)
ad_placement	ad_placement_id, ad_placement_name, the app columns and the channel columns

get/v2/reports/ad_revenue

Request

Base URL
https://api.tenjin.com
Auth
HTTP bearer

Query parameters

start_datestring date

Example:2026-09-01

First day to include, YYYY-MM-DD. Defaults to 30 days before today

end_datestring date

Example:2026-09-30

Last day to include, YYYY-MM-DD. Defaults to today

app_idsstring[]

Ids of the apps to report on, comma-separated; all accessible apps when blank

[
  "5ca0d40e-a595-430d-bb99-e188ee10d291"
]

channel_idsinteger[]

Ids of the channels to report on, comma-separated; all channels when blank

[
  3
]

granularity'daily' | 'weekly' | 'monthly' | 'totals-daily'

Period of each row. With totals-daily, one row covers the whole date range

metricsstring[]

Metrics to report, comma-separated; see the Metric Definitions

[
  "ad_revenue",
  "ecpm"
]

metric_filtersstring[]

Keep only rows where every filter holds. A filter is metric:op:value; op is gt, gte, lt, lte or eq

omit_blank_rowsboolean

Drop rows where every requested metric is zero or null

ad_network_idsinteger

Deprecated: use channel_ids. One ad network id, or several as ad_network_ids[]; ignored when channel_ids is sent

platformsstring

Ignored; returned unchanged in meta.platforms

countriesstring[]

Keep only these countries: two-letter country codes such as US, and UN for an unknown country

[
  "US",
  "JP"
]

group_bystring[]

Dimensions to group the rows by, comma-separated; any combination of them

[
  "channel",
  "app",
  "country"
]

pageinteger

Page of results to fetch.

per_pageinteger

Number of results to return per page.

Response

The report

Example response

{
  "data": [
    {
      "attributes": {
        "date": "2026-09-01",
        "app_name": "My Game",
        "platform": "ios",
        "bundle_id": "com.example.mygame",
        "store_id": "655745678",
        "ad_network_id": 3,
        "ad_network_name": "AppLovin",
        "ad_network_short_id": "applovin",
        "country_name": "US",
        "ad_placement_name": "Rewarded video"
      }
    }
  ],
  "meta": {
    "per_page": 100,
    "granularity": "daily"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.