openapi: 3.0.3
info:
  title: AppLovin Axon Campaign Management Ad Units Asset Reporting API
  version: v1
  x-generated-from: documentation
  x-source-url: https://support.axon.ai/en/app-discovery/api/axon-campaign-management-api/
  x-last-validated: '2026-05-05'
  description: 'REST endpoints used to programmatically manage AppLovin AppDiscovery

    (Axon) campaigns, creative sets, and creative assets. All endpoints

    require an `Authorization` header with the Campaign Management API key

    and an `account_id` query parameter. Rate limit: 1,000 requests per 60

    seconds (HTTP 429 on overflow).

    '
  contact:
    name: AppLovin Support
    url: https://support.axon.ai
servers:
- url: https://api.ads.axon.ai/manage/v1
  description: Axon campaign management API
security:
- bearerAuth: []
tags:
- name: Asset Reporting
  description: Creative-level performance reporting
paths:
  /assetReport:
    get:
      operationId: getAssetReport
      summary: Get Asset Report by Range
      description: 'Returns asset-level metrics (impressions, clicks, CTR, cost) for a

        symbolic time range such as `yesterday`, `last_7d`, or `last_month`.

        '
      tags:
      - Asset Reporting
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - name: range
        in: query
        required: true
        description: Symbolic time range.
        schema:
          type: string
          enum:
          - yesterday
          - last_7d
          - last_month
      - $ref: '#/components/parameters/Columns'
      - $ref: '#/components/parameters/Format'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/NotZero'
      responses:
        '200':
          description: Asset report rows
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AssetReportRow'
            text/csv:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /assetAnalyticsReport:
    get:
      operationId: getAssetAnalyticsReport
      summary: Get Asset Report by Date Range
      description: 'Returns asset-level metrics for an arbitrary YYYY-MM-DD date range

        bounded by a 45-day window.

        '
      tags:
      - Asset Reporting
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - $ref: '#/components/parameters/Start'
      - $ref: '#/components/parameters/End'
      - $ref: '#/components/parameters/Columns'
      - $ref: '#/components/parameters/Format'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/NotZero'
      responses:
        '200':
          description: Asset report rows
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AssetReportRow'
            text/csv:
              schema:
                type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  parameters:
    Columns:
      name: columns
      in: query
      required: true
      description: Comma-separated list of asset report columns.
      schema:
        type: string
        example: asset_id,asset_name,impressions,clicks,cost
    End:
      name: end
      in: query
      required: true
      description: Inclusive end date YYYY-MM-DD.
      schema:
        type: string
        format: date
    Format:
      name: format
      in: query
      required: false
      description: Response format. Defaults to JSON.
      schema:
        type: string
        enum:
        - json
        - csv
        default: json
    ApiKey:
      name: api_key
      in: query
      required: true
      description: Report Key from the Axon dashboard.
      schema:
        type: string
    Start:
      name: start
      in: query
      required: true
      description: Inclusive start date YYYY-MM-DD (45-day window with end).
      schema:
        type: string
        format: date
    Limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
    NotZero:
      name: not_zero
      in: query
      required: false
      description: Set to 1 to exclude all-zero rows.
      schema:
        type: integer
        enum:
        - 0
        - 1
    Offset:
      name: offset
      in: query
      required: false
      schema:
        type: integer
        minimum: 0
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    AssetReportRow:
      type: object
      description: 'Creative-level report row. x-schema-source: documentation

        '
      additionalProperties: true
      properties:
        asset_id:
          type: string
          description: Unique asset identifier.
        asset_name:
          type: string
          description: Human-friendly asset name.
        asset_url:
          type: string
          format: uri
          description: Raw pre-processed asset URL.
        campaign:
          type: string
          description: Campaign display name.
        campaign_id:
          type: string
          description: Unique campaign reference.
        campaign_package_name:
          type: string
          description: App package or bundle identifier.
        creative_set:
          type: string
          description: Creative set name.
        creative_set_id:
          type: string
          description: Creative set unique ID.
        impressions:
          type: integer
          description: Impression count.
        clicks:
          type: integer
          description: Click count.
        ctr:
          type: number
          description: Click-through rate.
        cost:
          type: number
          description: Advertiser spend in USD.
    Error:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
      required:
      - code
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Campaign Management API key passed in the `Authorization` header.