AppLovin Growth Reporting API

openapi: 3.0.3
info:
  title: AppLovin Axon Campaign Management Ad Units Growth 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: Growth Reporting
  description: Campaign performance reporting for advertisers and publishers
paths:
  /report:
    get:
      operationId: getGrowthReport
      summary: Get Growth Report
      description: 'Retrieve aggregated AppDiscovery / Axon campaign metrics for either

        the publisher or advertiser perspective. Date ranges are limited to a

        45-day rolling window. The response payload shape varies with the

        selected `columns` and `report_type`.

        '
      tags:
      - Growth Reporting
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      - $ref: '#/components/parameters/Start'
      - $ref: '#/components/parameters/End'
      - $ref: '#/components/parameters/Format'
      - $ref: '#/components/parameters/Columns'
      - $ref: '#/components/parameters/ReportType'
      - $ref: '#/components/parameters/DayColumn'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Offset'
      - $ref: '#/components/parameters/Having'
      - $ref: '#/components/parameters/NotZero'
      responses:
        '200':
          description: Report rows
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GrowthReportRow'
              example:
              - day: '2015-04-20'
                campaign: My Campaign
                impressions: 12345
                clicks: 678
                conversions: 90
                cost: '125.34'
            text/csv:
              schema:
                type: string
                description: CSV-encoded rows with header row.
        '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 columns to include. Available columns differ between publisher and advertiser report types.
      schema:
        type: string
        example: day,campaign,impressions,clicks,conversions,cost
    End:
      name: end
      in: query
      required: true
      description: Inclusive end date in YYYY-MM-DD, Unix epoch seconds, or the literal string `now`.
      schema:
        type: string
        example: now
    Format:
      name: format
      in: query
      required: true
      description: Response format.
      schema:
        type: string
        enum:
        - json
        - csv
    Having:
      name: having
      in: query
      required: false
      description: URL-encoded numeric filtering (e.g. `impressions > 0`).
      schema:
        type: string
    Offset:
      name: offset
      in: query
      required: false
      description: Pagination row offset.
      schema:
        type: integer
        minimum: 0
    ApiKey:
      name: api_key
      in: query
      required: true
      description: Report Key, found under Account > Keys in the Axon dashboard.
      schema:
        type: string
    DayColumn:
      name: day_column
      in: query
      required: false
      description: Set to `day` to compute cohort metrics. Defaults to realtime when absent.
      schema:
        type: string
        enum:
        - day
    Limit:
      name: limit
      in: query
      required: false
      description: Maximum rows to return.
      schema:
        type: integer
        minimum: 1
    NotZero:
      name: not_zero
      in: query
      required: false
      description: Set to 1 to exclude rows where all metrics are zero.
      schema:
        type: integer
        enum:
        - 0
        - 1
    Start:
      name: start
      in: query
      required: true
      description: Inclusive start date in YYYY-MM-DD or Unix epoch seconds. Must be within a 45-day window with end.
      schema:
        type: string
        example: '2015-04-20'
    ReportType:
      name: report_type
      in: query
      required: false
      description: Choose between publisher or advertiser report dimensions.
      schema:
        type: string
        enum:
        - publisher
        - advertiser
        default: publisher
  responses:
    Unauthorized:
      description: Missing or invalid api_key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    BadRequest:
      description: Malformed parameters or out-of-range date.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    GrowthReportRow:
      type: object
      description: 'Single Growth report row. Keys correspond to the requested `columns`;

        common columns are listed below. x-schema-source: documentation

        '
      additionalProperties: true
      properties:
        day:
          type: string
          format: date
          description: Reporting day in UTC.
        campaign:
          type: string
          description: Campaign display name.
        campaign_id:
          type: string
          description: Unique campaign identifier.
        country:
          type: string
          description: ISO 3166-1 alpha-2 country code.
        platform:
          type: string
          description: iOS or Android.
        package_name:
          type: string
          description: App identifier (bundle ID or package name).
        impressions:
          type: integer
          description: Impression count.
        clicks:
          type: integer
          description: Click count.
        ctr:
          type: number
          description: Click-through rate.
        conversions:
          type: integer
          description: Conversion / install count.
        cost:
          type: string
          description: 'Advertiser spend (publisher-side: revenue) in USD as a numeric string.'
        revenue:
          type: string
          description: Publisher revenue 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.