> ## 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/live

> Near real-time activity for one publisher over the last 1 to 48 hours: ad loads, bids, tag errors and latency. For daily history, use `/v1/report/insight/metrics`



## OpenAPI

````yaml /openapi.json get /v1/report/insight/live
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: AI
  - name: AI/Activity
  - name: Billing
  - name: Billing/Invoice
  - name: Audit Log
  - name: '[IN PROGRESS] Integration'
  - name: '[IN PROGRESS] Integration/Mapping'
  - name: '[IN PROGRESS] User'
  - name: '[IN PROGRESS] User/Account'
  - name: public
paths:
  /v1/report/insight/live:
    get:
      tags:
        - Reporting/Insights Hub/Live Insights
        - public
      summary: /report/insight/live
      description: >-
        Near real-time activity for one publisher over the last 1 to 48 hours:
        ad loads, bids, tag errors and latency. For daily history, use
        `/v1/report/insight/metrics`
      parameters:
        - name: uid
          in: query
          description: A single publisher ID
          required: true
          schema:
            type: integer
        - name: time
          in: query
          description: Time range in hours to return
          required: false
          schema:
            type: integer
            enum:
              - 1
              - 2
              - 4
              - 6
              - 12
              - 24
              - 48
            default: 2
        - name: environment
          in: query
          description: Environment or platform to report from
          required: false
          schema:
            type: string
            enum:
              - all
              - app
              - web
            default: all
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: object
                    properties:
                      dates:
                        type: array
                        description: >-
                          Start of each time bucket in UTC (YYYY-MM-DD
                          HH:MM:SS). Buckets are 1 to 6 minutes for up to 6
                          hours, and 15, 30 or 60 minutes for 12, 24 and 48
                          hours. Every series array has one value per bucket
                        items:
                          type: string
                      ad_impression:
                        type: array
                        description: >-
                          Viewable impression events recorded by the tag. Won't
                          match ad server impressions
                        items:
                          type: integer
                      ad_load:
                        type: array
                        description: Ads loaded (Plug&Play)
                        items:
                          type: integer
                      ad_load_saas:
                        type: array
                        description: Ads loaded (SaaS)
                        items:
                          type: integer
                      ad_miss:
                        type: array
                        description: Ad requests that came back empty (Plug&Play)
                        items:
                          type: integer
                      ad_miss_saas:
                        type: array
                        description: Ad requests that came back empty (SaaS)
                        items:
                          type: integer
                      ad_unit_load:
                        type: array
                        description: Ad units loaded on the page (Plug&Play)
                        items:
                          type: integer
                      ad_unit_load_saas:
                        type: array
                        description: Ad units loaded on the page (SaaS)
                        items:
                          type: integer
                      tag_error:
                        type: array
                        description: Errors reported by the tag
                        items:
                          type: integer
                      page_impression:
                        type: array
                        description: Pages the tag loaded on
                        items:
                          type: integer
                      ad_latency_50th:
                        type: array
                        description: >-
                          Median time to load an ad, in milliseconds. 0 when
                          there's no data
                        items:
                          type: number
                      unit_latency_50th:
                        type: array
                        description: >-
                          Median time to load an ad unit, in milliseconds. 0
                          when there's no data
                        items:
                          type: number
                      tag_latency_50th:
                        type: array
                        description: >-
                          Median time for the tag to load, in milliseconds. 0
                          when there's no data
                        items:
                          type: number
                      page_latency_50th:
                        type: array
                        description: >-
                          Median page load time, in milliseconds. 0 when there's
                          no data
                        items:
                          type: number
                      dom_latency_50th:
                        type: array
                        description: >-
                          Median time until the page's DOM was ready, in
                          milliseconds. 0 when there's no data
                        items:
                          type: number
                      no_bid:
                        type: array
                        description: Header bidding requests an SSP didn't bid on
                        items:
                          type: integer
                      bid:
                        type: array
                        description: Header bidding bids received
                        items:
                          type: integer
                      bid_won:
                        type: array
                        description: Header bidding bids that won the impression
                        items:
                          type: integer
                      bid_throttled:
                        type: array
                        description: Header bidding requests held back by bid throttling
                        items:
                          type: integer
                      tag_error_types:
                        type: array
                        description: >-
                          Tag errors over the whole window, grouped by type,
                          most frequent first
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: >-
                                The error type, such as 'Network Request
                                Failed'. Errors that don't match a known type
                                keep their own message
                            count:
                              type: integer
                              description: Errors of this type
                            rate:
                              type: number
                              description: Errors of this type per page impression
                            details:
                              type: array
                              description: >-
                                Breakdown by detail found in the error, such as
                                source or reason, most frequent first
                              items:
                                type: object
                                properties:
                                  label:
                                    type: string
                                  value:
                                    anyOf:
                                      - type: string
                                      - type: number
                                  count:
                                    type: integer
                                required:
                                  - label
                                  - value
                                  - count
                            network_average:
                              type: number
                              description: >-
                                Average rate for this error type across all
                                publishers over the last 7 days
                              nullable: true
                          required:
                            - type
                            - count
                            - rate
                            - details
                            - network_average
                      tag_error_type_categories:
                        type: array
                        description: >-
                          The error types used as keys in
                          `tag_error_type_series`, ending with 'Unknown'
                        items:
                          type: string
                      tag_error_type_series:
                        type: object
                        description: >-
                          Tag errors per bucket for each type in
                          `tag_error_type_categories`. Errors that don't match a
                          known type count as 'Unknown'
                        additionalProperties:
                          type: array
                          items:
                            type: integer
                        properties: {}
                      tag_error_type_details:
                        type: array
                        description: >-
                          Tag errors grouped by type for each bucket, lined up
                          with `dates`
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              description: Start of the bucket
                            types:
                              type: array
                              items:
                                type: object
                                properties:
                                  type:
                                    type: string
                                  count:
                                    type: integer
                                  rate:
                                    type: number
                                    description: >-
                                      Errors of this type per page impression in
                                      the bucket
                                  details:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        label:
                                          type: string
                                        value:
                                          anyOf:
                                            - type: string
                                            - type: number
                                        count:
                                          type: integer
                                      required:
                                        - label
                                        - value
                                        - count
                                required:
                                  - type
                                  - count
                                  - rate
                                  - details
                          required:
                            - date
                            - types
                    required:
                      - dates
                      - ad_impression
                      - ad_load
                      - ad_load_saas
                      - ad_miss
                      - ad_miss_saas
                      - ad_unit_load
                      - ad_unit_load_saas
                      - tag_error
                      - page_impression
                      - ad_latency_50th
                      - unit_latency_50th
                      - tag_latency_50th
                      - page_latency_50th
                      - dom_latency_50th
                      - no_bid
                      - bid
                      - bid_won
                      - bid_throttled
                      - tag_error_types
                      - tag_error_type_categories
                      - tag_error_type_series
                      - tag_error_type_details
                  success:
                    type: boolean
                required:
                  - results
                  - success
              example:
                results:
                  dates:
                    - '2026-10-23 09:01:00'
                    - '2026-10-23 09:02:00'
                    - '2026-10-23 09:03:00'
                  ad_impression:
                    - 612
                    - 590
                    - 640
                  ad_load:
                    - 905
                    - 871
                    - 934
                  ad_load_saas:
                    - 0
                    - 0
                    - 0
                  ad_miss:
                    - 118
                    - 109
                    - 122
                  ad_miss_saas:
                    - 0
                    - 0
                    - 0
                  ad_unit_load:
                    - 1236
                    - 1194
                    - 1275
                  ad_unit_load_saas:
                    - 0
                    - 0
                    - 0
                  tag_error:
                    - 3
                    - 1
                    - 2
                  page_impression:
                    - 412
                    - 398
                    - 425
                  ad_latency_50th:
                    - 812.5
                    - 790
                    - 835
                  unit_latency_50th:
                    - 1450
                    - 1422.5
                    - 1489
                  tag_latency_50th:
                    - 210
                    - 205.5
                    - 214
                  page_latency_50th:
                    - 1890
                    - 1845
                    - 1920
                  dom_latency_50th:
                    - 1320
                    - 1298.5
                    - 1341
                  no_bid:
                    - 5120
                    - 4987
                    - 5233
                  bid:
                    - 2210
                    - 2105
                    - 2302
                  bid_won:
                    - 341
                    - 322
                    - 355
                  bid_throttled:
                    - 410
                    - 395
                    - 428
                  tag_error_types:
                    - type: Network Request Failed
                      count: 4
                      rate: 0.003238866
                      details:
                        - label: reason
                          value: Failed to fetch
                          count: 3
                        - label: reason
                          value: Load failed
                          count: 1
                      network_average: 0.0021
                    - type: GPT Load Failed
                      count: 2
                      rate: 0.001619433
                      details: []
                      network_average: 0.00087
                  tag_error_type_categories:
                    - Domain mismatch
                    - GPT Load Failed
                    - GPT PubAds Unavailable
                    - Secure Signal Provider Push Failed
                    - Prebid BidsBackHandler Failed
                    - Network Request Failed
                    - Window Property Access Denied
                    - Prebid Build Load Failed
                    - GPT Slot Definition Failed
                    - Heavy Ad Intervention
                    - 'Reference Error: Can''t Find Variable'
                    - 'Type Error: Cannot Read Properties Of Null'
                    - >-
                      Security Error: Blocked A Frame From Accessing A Cross
                      Origin Frame
                    - 'Security Error: The Operation Is Insecure'
                    - Unknown
                  tag_error_type_series:
                    Domain mismatch:
                      - 0
                      - 0
                      - 0
                    GPT Load Failed:
                      - 1
                      - 0
                      - 1
                    GPT PubAds Unavailable:
                      - 0
                      - 0
                      - 0
                    Secure Signal Provider Push Failed:
                      - 0
                      - 0
                      - 0
                    Prebid BidsBackHandler Failed:
                      - 0
                      - 0
                      - 0
                    Network Request Failed:
                      - 2
                      - 1
                      - 1
                    Window Property Access Denied:
                      - 0
                      - 0
                      - 0
                    Prebid Build Load Failed:
                      - 0
                      - 0
                      - 0
                    GPT Slot Definition Failed:
                      - 0
                      - 0
                      - 0
                    Heavy Ad Intervention:
                      - 0
                      - 0
                      - 0
                    'Reference Error: Can''t Find Variable':
                      - 0
                      - 0
                      - 0
                    'Type Error: Cannot Read Properties Of Null':
                      - 0
                      - 0
                      - 0
                    'Security Error: Blocked A Frame From Accessing A Cross Origin Frame':
                      - 0
                      - 0
                      - 0
                    'Security Error: The Operation Is Insecure':
                      - 0
                      - 0
                      - 0
                    Unknown:
                      - 0
                      - 0
                      - 0
                  tag_error_type_details:
                    - date: '2026-10-23 09:01:00'
                      types:
                        - type: Network Request Failed
                          count: 2
                          rate: 0.004854369
                          details:
                            - label: reason
                              value: Failed to fetch
                              count: 2
                        - type: GPT Load Failed
                          count: 1
                          rate: 0.002427184
                          details: []
                    - date: '2026-10-23 09:02:00'
                      types:
                        - type: Network Request Failed
                          count: 1
                          rate: 0.002512563
                          details:
                            - label: reason
                              value: Load failed
                              count: 1
                    - date: '2026-10-23 09:03:00'
                      types:
                        - type: GPT Load Failed
                          count: 1
                          rate: 0.002352941
                          details: []
                        - type: Network Request Failed
                          count: 1
                          rate: 0.002352941
                          details:
                            - label: reason
                              value: Failed to fetch
                              count: 1
                success: true
          headers: {}
      deprecated: false
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.