> ## Documentation Index
> Fetch the complete documentation index at: https://docs.contentignite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /report/insight/revenue/dimension

> Returns revenue data for a specified dimension, including publisher, ad_unit_type, config, geo, region, device, channel, partner, or creative_size



## OpenAPI

````yaml /openapi.json get /v1/report/insight/revenue/dimension
openapi: 3.0.1
info:
  title: CI Public API
  description: >-
    # Introduction

    Welcome to the Content Ignite API. A central place for all Content Ignite
    functionality. 


    This API enforces a separation between function and form, meaning anything
    you can do in our platforms can be replicated in your own bespoke solution.


    # Authentication

    Authentication is handled via JWTs. You can retrieve your unique JSON Web
    Token from the settings page in the platform, which needs to be passed in
    with every request.

    To do this, simple include it in an Authorization header with the "Bearer"
    key word.


    Please contact support for help getting started.


    # Error Codes

    This is a fully RESTful API, so prepare for a number of different HTTP
    status codes.


    There is also a standard "success" field returned for each request. This
    boolean value can provide a first check against a response.


    # Rate limit

    We reserve the right to block requests if we deem a client to be abusing the
    API.
  version: 1.0.0
servers:
  - url: https://api.tagdeliver.com
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Reporting
  - name: Reporting/Revenue Reports
  - name: Reporting/Experiment Reporting
  - name: Reporting/Campaign Reports
  - name: Reporting/Health Check
  - name: Reporting/Ads.txt
  - name: Reporting/Utility
  - name: Reporting/Insights Hub
  - name: Reporting/Insights Hub/SSP Insights
  - name: Reporting/Insights Hub/Core Web Vitals
  - name: Reporting/Insights Hub/Ads.txt Insights
  - name: Reporting/Insights Hub/Live Insights
  - name: Reporting/Insights Hub/Metrics
  - name: Reporting/Insights Hub/Diagnostics
  - name: Reporting/Insights Hub/Revenue Insights
  - name: Reporting/Insights Hub/Revenue Analytics
  - name: Reporting/Insights Hub/Demand Mix
  - name: Reporting/Insights Hub/Benchmarking
  - name: Organisation
  - name: Organisation/Organisation Meta
  - name: Organisation/Pricing
  - name: Ad Stack
  - name: Ad Stack/Integration
  - name: Publisher
  - name: Publisher/Publisher Stack
  - name: Publisher/Publisher Tag
  - name: Publisher/Publisher Meta
  - name: Publisher/Experiment
  - name: Publisher/Config (Ad unit)
  - name: Publisher/App Placement
  - name: Billing
  - name: Billing/Invoice
  - name: '[IN PROGRESS] Integration'
  - name: '[TODO] User'
  - name: '[TODO] User/Account'
  - name: public
paths:
  /v1/report/insight/revenue/dimension:
    get:
      tags:
        - Reporting/Insights Hub/Revenue Insights
        - public
      summary: /report/insight/revenue/dimension
      description: >-
        Returns revenue data for a specified dimension, including publisher,
        ad_unit_type, config, geo, region, device, channel, partner, or
        creative_size
      parameters:
        - name: uid
          in: query
          description: Publisher ID
          required: false
          example: 0
          schema:
            type: integer
        - name: range
          in: query
          description: Date range. All ranges exclude today and run up to yesterday
          required: false
          example: ''
          schema:
            type: string
            enum:
              - 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
        - name: start
          in: query
          description: Start date when range=custom
          required: false
          example: ''
          schema:
            type: string
            format: date
        - name: end
          in: query
          description: End date when range=custom
          required: false
          example: ''
          schema:
            type: string
            format: date
        - name: date_group
          in: query
          description: Date grouping when range=custom
          required: false
          example: ''
          schema:
            type: string
            enum:
              - day
              - month
              - year
            default: day
        - name: rev_source
          in: query
          description: Revenue source, SaaS or Plug&Play (pap)
          required: false
          example: ''
          schema:
            type: string
            enum:
              - all
              - pap
              - saas
            default: all
        - name: tab
          in: query
          description: The dimension to report on
          required: false
          example: ''
          schema:
            type: string
            enum:
              - publisher
              - ad_unit_type
              - config
              - geo
              - region
              - device
              - channel
              - partner
              - creative_size
            default: publisher
        - name: environment
          in: query
          description: Environment or platform to report from
          required: false
          example: ''
          schema:
            type: string
            enum:
              - all
              - app
              - web
            default: all
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: object
                    properties:
                      currency:
                        type: string
                      dates:
                        type: array
                        items:
                          type: string
                      dimension:
                        type: object
                        properties:
                          tablet:
                            type: object
                            properties:
                              gross_revenue:
                                type: array
                                items:
                                  type: number
                              pap_gross_revenue:
                                type: array
                                items:
                                  type: number
                              saas_gross_revenue:
                                type: array
                                items:
                                  type: number
                              net_revenue:
                                type: array
                                items:
                                  type: number
                              pap_net_revenue:
                                type: array
                                items:
                                  type: number
                              saas_net_revenue:
                                type: array
                                items:
                                  type: number
                              impressions:
                                type: array
                                items:
                                  type: integer
                              pap_impressions:
                                type: array
                                items:
                                  type: integer
                              saas_impressions:
                                type: array
                                items:
                                  type: integer
                            required:
                              - gross_revenue
                              - pap_gross_revenue
                              - saas_gross_revenue
                              - net_revenue
                              - pap_net_revenue
                              - saas_net_revenue
                              - impressions
                              - pap_impressions
                              - saas_impressions
                          mobile:
                            type: object
                            properties:
                              gross_revenue:
                                type: array
                                items:
                                  type: number
                              pap_gross_revenue:
                                type: array
                                items:
                                  type: number
                              saas_gross_revenue:
                                type: array
                                items:
                                  type: number
                              net_revenue:
                                type: array
                                items:
                                  type: number
                              pap_net_revenue:
                                type: array
                                items:
                                  type: number
                              saas_net_revenue:
                                type: array
                                items:
                                  type: number
                              impressions:
                                type: array
                                items:
                                  type: integer
                              pap_impressions:
                                type: array
                                items:
                                  type: integer
                              saas_impressions:
                                type: array
                                items:
                                  type: integer
                            required:
                              - gross_revenue
                              - pap_gross_revenue
                              - saas_gross_revenue
                              - net_revenue
                              - pap_net_revenue
                              - saas_net_revenue
                              - impressions
                              - pap_impressions
                              - saas_impressions
                          desktop:
                            type: object
                            properties:
                              gross_revenue:
                                type: array
                                items:
                                  type: number
                              pap_gross_revenue:
                                type: array
                                items:
                                  type: number
                              saas_gross_revenue:
                                type: array
                                items:
                                  type: number
                              net_revenue:
                                type: array
                                items:
                                  type: number
                              pap_net_revenue:
                                type: array
                                items:
                                  type: number
                              saas_net_revenue:
                                type: array
                                items:
                                  type: number
                              impressions:
                                type: array
                                items:
                                  type: integer
                              pap_impressions:
                                type: array
                                items:
                                  type: integer
                              saas_impressions:
                                type: array
                                items:
                                  type: integer
                            required:
                              - gross_revenue
                              - pap_gross_revenue
                              - saas_gross_revenue
                              - net_revenue
                              - pap_net_revenue
                              - saas_net_revenue
                              - impressions
                              - pap_impressions
                              - saas_impressions
                        required:
                          - tablet
                          - mobile
                          - desktop
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            dimension:
                              type: string
                            gross_revenue:
                              type: number
                            pap_gross_revenue:
                              type: number
                            saas_gross_revenue:
                              type: number
                            net_revenue:
                              type: number
                            pap_net_revenue:
                              type: number
                            saas_net_revenue:
                              type: number
                            impressions:
                              type: integer
                            pap_impressions:
                              type: integer
                            saas_impressions:
                              type: integer
                            viewable_impressions:
                              type: integer
                            pap_viewable_impressions:
                              type: integer
                            saas_viewable_impressions:
                              type: integer
                            ad_unit_loads:
                              type: integer
                            pap_ad_unit_loads:
                              type: integer
                            saas_ad_unit_loads:
                              type: integer
                            ad_requests:
                              type: integer
                            pap_ad_requests:
                              type: integer
                            saas_ad_requests:
                              type: integer
                            ad_responses:
                              type: integer
                            pap_ad_responses:
                              type: integer
                            saas_ad_responses:
                              type: integer
                          required:
                            - date
                            - dimension
                            - gross_revenue
                            - pap_gross_revenue
                            - saas_gross_revenue
                            - net_revenue
                            - pap_net_revenue
                            - saas_net_revenue
                            - impressions
                            - pap_impressions
                            - saas_impressions
                            - viewable_impressions
                            - pap_viewable_impressions
                            - saas_viewable_impressions
                            - ad_unit_loads
                            - pap_ad_unit_loads
                            - saas_ad_unit_loads
                            - ad_requests
                            - pap_ad_requests
                            - saas_ad_requests
                            - ad_responses
                            - pap_ad_responses
                            - saas_ad_responses
                    required:
                      - currency
                      - dates
                      - dimension
                      - data
                  success:
                    type: boolean
                required:
                  - results
                  - success
              example:
                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
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````