Skip to main content
GET
/
v1
/
report
/
insight
/
revenue
/
dimension
/report/insight/revenue/dimension
curl --request GET \
  --url https://api.tagdeliver.com/v1/report/insight/revenue/dimension \
  --header 'Authorization: Bearer <token>'
{
  "results": {
    "currency": "GBP",
    "dates": [
      "2025-11-23"
    ],
    "dimension": {
      "tablet": {
        "gross_revenue": [
          976.487424763
        ],
        "pap_gross_revenue": [
          613.541002763
        ],
        "saas_gross_revenue": [
          362.946422
        ],
        "net_revenue": [
          855.4523958339998
        ],
        "pap_net_revenue": [
          495.135233834
        ],
        "saas_net_revenue": [
          360.31716200000005
        ],
        "impressions": [
          902422
        ],
        "pap_impressions": [
          699733
        ],
        "saas_impressions": [
          202689
        ]
      },
      "mobile": {
        "gross_revenue": [
          20167.981779762
        ],
        "pap_gross_revenue": [
          14595.839224762
        ],
        "saas_gross_revenue": [
          5572.142555
        ],
        "net_revenue": [
          17229.788437384002
        ],
        "pap_net_revenue": [
          11716.874572384
        ],
        "saas_net_revenue": [
          5512.913865
        ],
        "impressions": [
          22664602
        ],
        "pap_impressions": [
          19192531
        ],
        "saas_impressions": [
          3472071
        ]
      },
      "unknown": {
        "gross_revenue": [
          1.081099
        ],
        "pap_gross_revenue": [
          0.344539
        ],
        "saas_gross_revenue": [
          0.73656
        ],
        "net_revenue": [
          1.002199
        ],
        "pap_net_revenue": [
          0.273249
        ],
        "saas_net_revenue": [
          0.7289500000000001
        ],
        "impressions": [
          1091
        ],
        "pap_impressions": [
          806
        ],
        "saas_impressions": [
          285
        ]
      },
      "desktop": {
        "gross_revenue": [
          4646.571965953
        ],
        "pap_gross_revenue": [
          1327.229455953
        ],
        "saas_gross_revenue": [
          3319.34251
        ],
        "net_revenue": [
          4369.314133807999
        ],
        "pap_net_revenue": [
          1075.289433808
        ],
        "saas_net_revenue": [
          3294.0247000000004
        ],
        "impressions": [
          2870419
        ],
        "pap_impressions": [
          1983747
        ],
        "saas_impressions": [
          886672
        ]
      }
    },
    "data": [
      {
        "date": "2025-11-23",
        "dimension": "tablet",
        "gross_revenue": 976.487424763,
        "pap_gross_revenue": 613.541002763,
        "saas_gross_revenue": 362.946422,
        "net_revenue": 855.4523958339998,
        "pap_net_revenue": 495.135233834,
        "saas_net_revenue": 360.31716200000005,
        "impressions": 902422,
        "pap_impressions": 699733,
        "saas_impressions": 202689,
        "viewable_impressions": 679410,
        "pap_viewable_impressions": 557736,
        "saas_viewable_impressions": 121674,
        "ad_unit_loads": 35651462,
        "pap_ad_unit_loads": 31204238,
        "saas_ad_unit_loads": 4447224,
        "ad_requests": 41025017,
        "pap_ad_requests": 39191837,
        "saas_ad_requests": 1833180,
        "ad_responses": 27614791,
        "pap_ad_responses": 26050029,
        "saas_ad_responses": 1564762
      },
      {
        "date": "2025-11-23",
        "dimension": "mobile",
        "gross_revenue": 20167.981779762,
        "pap_gross_revenue": 14595.839224762,
        "saas_gross_revenue": 5572.142555,
        "net_revenue": 17229.788437384002,
        "pap_net_revenue": 11716.874572384,
        "saas_net_revenue": 5512.913865,
        "impressions": 22664602,
        "pap_impressions": 19192531,
        "saas_impressions": 3472071,
        "viewable_impressions": 18362943,
        "pap_viewable_impressions": 15928111,
        "saas_viewable_impressions": 2434832,
        "ad_unit_loads": 36311747,
        "pap_ad_unit_loads": 31505737,
        "saas_ad_unit_loads": 4806010,
        "ad_requests": 41324481,
        "pap_ad_requests": 39397676,
        "saas_ad_requests": 1926805,
        "ad_responses": 27581298,
        "pap_ad_responses": 26009810,
        "saas_ad_responses": 1571488
      },
      {
        "date": "2025-11-23",
        "dimension": "unknown",
        "gross_revenue": 1.081099,
        "pap_gross_revenue": 0.344539,
        "saas_gross_revenue": 0.73656,
        "net_revenue": 1.002199,
        "pap_net_revenue": 0.273249,
        "saas_net_revenue": 0.7289500000000001,
        "impressions": 1091,
        "pap_impressions": 806,
        "saas_impressions": 285,
        "viewable_impressions": 838,
        "pap_viewable_impressions": 681,
        "saas_viewable_impressions": 157,
        "ad_unit_loads": 22780474,
        "pap_ad_unit_loads": 21132751,
        "saas_ad_unit_loads": 1647723,
        "ad_requests": 34271823,
        "pap_ad_requests": 33776066,
        "saas_ad_requests": 495757,
        "ad_responses": 22095813,
        "pap_ad_responses": 21662644,
        "saas_ad_responses": 433169
      },
      {
        "date": "2025-11-23",
        "dimension": "desktop",
        "gross_revenue": 4646.571965953,
        "pap_gross_revenue": 1327.229455953,
        "saas_gross_revenue": 3319.34251,
        "net_revenue": 4369.314133807999,
        "pap_net_revenue": 1075.289433808,
        "saas_net_revenue": 3294.0247000000004,
        "impressions": 2870419,
        "pap_impressions": 1983747,
        "saas_impressions": 886672,
        "viewable_impressions": 2148541,
        "pap_viewable_impressions": 1570707,
        "saas_viewable_impressions": 577834,
        "ad_unit_loads": 35862530,
        "pap_ad_unit_loads": 31454753,
        "saas_ad_unit_loads": 4407777,
        "ad_requests": 41055245,
        "pap_ad_requests": 39199639,
        "saas_ad_requests": 1855606,
        "ad_responses": 27543618,
        "pap_ad_responses": 25986225,
        "saas_ad_responses": 1557393
      }
    ]
  },
  "success": true
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
uid
integer

Publisher ID

​
range
enum<string>

Date range. All ranges exclude today and run up to yesterday

Available options:
custom,
all_time,
seven_days,
fourteen_days,
thirty_days,
three_months,
six_months,
week_to_date,
month_to_date,
quarter_to_date,
year_to_date,
last_week,
last_month,
last_quarter,
last_year,
month_on_month,
quarter_on_quarter,
yesterday
​
start
string<date>

Start date when range=custom

​
end
string<date>

End date when range=custom

​
date_group
enum<string>
default:day

Date grouping when range=custom

Available options:
day,
month,
year
​
rev_source
enum<string>
default:all

Revenue source, SaaS or Plug&Play (pap)

Available options:
all,
pap,
saas
​
tab
enum<string>
default:publisher

The dimension to report on

Available options:
publisher,
ad_unit_type,
config,
geo,
region,
device,
channel,
partner,
creative_size
​
environment
enum<string>
default:all

Environment or platform to report from

Available options:
all,
app,
web

Response

200 - application/json
​
results
object
required
​
success
boolean
required