> ## 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.

# /ai/activity/trends

> Cost, usage and adoption for fixed lookbacks (last 7 and 14 days, last week, month and quarter), each against the period before it, with this month's projected cost and a 14-day daily series. Every filter applies except the date range. Only available to admins. Results cover the organisations your account can access.



## OpenAPI

````yaml /openapi.json get /v1/ai/activity/trends
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/ai/activity/trends:
    get:
      tags:
        - AI/Activity
        - public
      summary: /ai/activity/trends
      description: >-
        Cost, usage and adoption for fixed lookbacks (last 7 and 14 days, last
        week, month and quarter), each against the period before it, with this
        month's projected cost and a 14-day daily series. Every filter applies
        except the date range. Only available to admins. Results cover the
        organisations your account can access.
      parameters:
        - name: source
          in: query
          description: >-
            Only include one route: `chat` (Spark questions and chat naming) or
            `summary` (AI summaries)
          required: false
          schema:
            type: string
            enum:
              - chat
              - summary
        - name: organisation_id
          in: query
          description: Comma-separated organisation IDs
          required: false
          schema:
            type: string
        - name: user_id
          in: query
          description: Comma-separated user IDs
          required: false
          schema:
            type: string
        - name: outcome
          in: query
          description: Only include successful or failed requests
          required: false
          schema:
            type: string
            enum:
              - success
              - failure
        - name: user_type
          in: query
          description: Only include admins (`admin`) or everyone else (`non_admin`)
          required: false
          schema:
            type: string
            enum:
              - admin
              - non_admin
        - name: exclude_internal
          in: query
          description: Set to `1` to leave out internal organisations
          required: false
          schema:
            type: string
            enum:
              - '0'
              - '1'
            default: '0'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        range:
                          type: string
                          description: Lookback
                          enum:
                            - seven_days
                            - fourteen_days
                            - last_week
                            - last_month
                            - last_quarter
                        start:
                          type: string
                          description: First day of the lookback (Y-m-d)
                        end:
                          type: string
                          description: Last day of the lookback (Y-m-d)
                        compare_start:
                          type: string
                          description: First day of the period before
                          nullable: true
                        compare_end:
                          type: string
                          description: Last day of the period before
                          nullable: true
                        current:
                          type: object
                          properties:
                            activity:
                              type: integer
                              description: Questions plus summary generations
                            chat_cost_gbp:
                              type: number
                              description: Spark chat cost, in GBP
                            cost_gbp:
                              type: number
                              description: Total cost, in GBP
                            cost_usd:
                              type: number
                              description: Total cost, in USD
                            failures:
                              type: integer
                              description: Failed questions and summary generations
                            questions:
                              type: integer
                              description: Spark questions
                            summaries:
                              type: integer
                              description: AI summary generations
                            summary_cost_gbp:
                              type: number
                              description: AI summaries cost, in GBP
                            users:
                              type: integer
                              description: Users with activity
                            organisations:
                              type: integer
                              description: Organisations with activity
                          required:
                            - activity
                            - chat_cost_gbp
                            - cost_gbp
                            - cost_usd
                            - failures
                            - questions
                            - summaries
                            - summary_cost_gbp
                            - users
                            - organisations
                        previous:
                          type: object
                          properties:
                            activity:
                              type: integer
                              description: Questions plus summary generations
                            chat_cost_gbp:
                              type: number
                              description: Spark chat cost, in GBP
                            cost_gbp:
                              type: number
                              description: Total cost, in GBP
                            cost_usd:
                              type: number
                              description: Total cost, in USD
                            failures:
                              type: integer
                              description: Failed questions and summary generations
                            questions:
                              type: integer
                              description: Spark questions
                            summaries:
                              type: integer
                              description: AI summary generations
                            summary_cost_gbp:
                              type: number
                              description: AI summaries cost, in GBP
                            users:
                              type: integer
                              description: Users with activity
                            organisations:
                              type: integer
                              description: Organisations with activity
                          required:
                            - activity
                            - chat_cost_gbp
                            - cost_gbp
                            - cost_usd
                            - failures
                            - questions
                            - summaries
                            - summary_cost_gbp
                            - users
                            - organisations
                      required:
                        - range
                        - start
                        - end
                        - compare_start
                        - compare_end
                        - current
                        - previous
                    description: Each fixed lookback with the period before it
                  projection:
                    type: object
                    properties:
                      days_elapsed:
                        type: integer
                        description: Days of the month so far, today included
                      days_in_month:
                        type: integer
                        description: Days in the month
                      month_to_date_gbp:
                        type: number
                        description: Cost this month so far, in GBP
                      month_to_date_usd:
                        type: number
                        description: Cost this month so far, in USD
                      projected_gbp:
                        type: number
                        description: >-
                          Month to date at the same daily rate for the whole
                          month, in GBP
                      projected_usd:
                        type: number
                        description: The same, in USD
                    required:
                      - days_elapsed
                      - days_in_month
                      - month_to_date_gbp
                      - month_to_date_usd
                      - projected_gbp
                      - projected_usd
                    description: This month's projected cost
                  daily:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                          description: Day (Y-m-d)
                        cost_gbp:
                          type: number
                          description: Cost, in GBP
                        activity:
                          type: integer
                          description: Questions plus summary generations
                        failures:
                          type: integer
                          description: Failures
                        users:
                          type: integer
                          description: Users with activity
                      required:
                        - date
                        - cost_gbp
                        - activity
                        - failures
                        - users
                    description: The last 14 full days, ending yesterday
                  success:
                    type: boolean
                required:
                  - results
                  - projection
                  - daily
                  - success
              example:
                results:
                  - range: seven_days
                    start: '2026-10-20'
                    end: '2026-10-26'
                    compare_start: '2026-10-13'
                    compare_end: '2026-10-19'
                    current:
                      activity: 140
                      chat_cost_gbp: 6.55
                      cost_gbp: 36.33
                      cost_usd: 48.55
                      failures: 6
                      questions: 54
                      summaries: 86
                      summary_cost_gbp: 29.78
                      users: 50
                      organisations: 35
                    previous:
                      activity: 140
                      chat_cost_gbp: 6.55
                      cost_gbp: 49.37
                      cost_usd: 48.55
                      failures: 6
                      questions: 54
                      summaries: 86
                      summary_cost_gbp: 29.78
                      users: 50
                      organisations: 35
                projection:
                  days_elapsed: 27
                  days_in_month: 31
                  month_to_date_gbp: 200.9
                  month_to_date_usd: 266.5
                  projected_gbp: 230.66
                  projected_usd: 305.98
                daily:
                  - date: '2026-10-26'
                    cost_gbp: 4.12
                    activity: 21
                    failures: 1
                    users: 9
                success: true
          headers: {}
        '403':
          description: Not an admin
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                message: User forbidden
          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.