/report/insight/revenue

Revenue and ad delivery over time, as totals and a date series.

The daily rows in data also hold viewable impressions, ad requests, ad responses and ad unit loads, for working out rates as Fusion does: viewability = viewable_impressions ÷ impressions, eCPM = gross_revenue ÷ impressions × 1,000, eRPM = net_revenue ÷ impressions × 1,000, Fill = impressions ÷ ad_requests, Ad Server Fill = ad_responses ÷ ad_requests, Unit Fill = ad_responses ÷ ad_unit_loads. Fill on its own always means impressions ÷ ad_requests

For a breakdown by dimension, use /v1/report/insight/revenue/dimension

GET /v1/report/insight/revenue

/report/insight/revenue

cURL

curl --request GET \
  --url https://api.tagdeliver.com/v1/report/insight/revenue \
  --header 'Authorization: Bearer <token>'

200

{
  "results": {
    "currency": "GBP",
    "totals": {
      "gross_revenue": 25792.122269478,
      "pap_gross_revenue": 16536.954222478,
      "saas_gross_revenue": 9255.168047,
      "net_revenue": 22455.557166026,
      "pap_net_revenue": 13287.572489026,
      "saas_net_revenue": 9167.984676999997,
      "impressions": 26438534,
      "pap_impressions": 21876817,
      "saas_impressions": 4561717
    },
    "dates": [
      "2025-11-23"
    ],
    "dates_data": {
      "gross_revenue": [
        25792.122269478
      ],
      "pap_gross_revenue": [
        16536.954222478
      ],
      "saas_gross_revenue": [
        9255.168047
      ],
      "net_revenue": [
        22455.557166026
      ],
      "pap_net_revenue": [
        13287.572489026
      ],
      "saas_net_revenue": [
        9167.984676999997
      ],
      "impressions": [
        26438534
      ],
      "pap_impressions": [
        21876817
      ],
      "saas_impressions": [
        4561717
      ]
    },
    "data": [
      {
        "date": "2025-11-23",
        "gross_revenue": 25792.122269478,
        "pap_gross_revenue": 16536.954222478,
        "saas_gross_revenue": 9255.168047,
        "net_revenue": 22455.557166026,
        "pap_net_revenue": 13287.572489026,
        "saas_net_revenue": 9167.984676999997,
        "impressions": 26438534,
        "pap_impressions": 21876817,
        "saas_impressions": 4561717,
        "viewable_impressions": 21191732,
        "pap_viewable_impressions": 18057235,
        "saas_viewable_impressions": 3134497,
        "ad_unit_loads": 37518998,
        "pap_ad_unit_loads": 32632769,
        "saas_ad_unit_loads": 4886229,
        "ad_requests": 41698518,
        "pap_ad_requests": 39735018,
        "saas_ad_requests": 1963500,
        "ad_responses": 27790415,
        "pap_ad_responses": 26183982,
        "saas_ad_responses": 1606433
      }
    ]
  },
  "success": true
}

Authorizations

Authorization · string · header · required

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

Query Parameters

uid · string

One or more publisher IDs, comma-separated. Defaults to all publishers in your organisation

range · enum<string>

Date range to report on. Preset ranges end yesterday. month_to_date is the current month so far and week_to_date is the current week so far. month_on_month and quarter_on_quarter return monthly or quarterly totals, with the latest period incomplete. custom requires start and end (YYYY-MM-DD). Other values return a 400 error

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

Groups the series by day, month or quarter. month_on_month and quarter_on_quarter group automatically

Available options: day, month, quarter

environment · enum<string> · default: all

Environment or platform to report from

Available options: all, app, web

Response

200 - application/json

results · object · required

Show child attributes

success · boolean · required