# 1019-App-Active Users

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /analysis/active-user:
    post:
      summary: 1019-App-Active Users
      deprecated: false
      description: Query active user data within a time range (DAU, MAU).
      operationId: 1019_App_Active Users
      tags:
        - II. List of Interfaces/1. application Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                regions:
                  type: array
                  description: |-
                    Country set
                    Optional, default global
                  examples:
                    - - CN
                appId:
                  type: string
                  description: App ID
                  examples:
                    - '989673964'
                activeTimeType:
                  type: string
                  description: Active time type (DAY=DAU, MONTH=MAU)
                  examples:
                    - DAY
                start:
                  type: string
                  description: Start date (validated per parameters)
                  examples:
                    - '2025-11-01'
                end:
                  type: string
                  description: End date (validated per parameters)
                  examples:
                    - '2025-11-02'
              required:
                - regions
              x-apifox-orders:
                - regions
                - appId
                - activeTimeType
                - start
                - end
              x-apifox-ignore-properties: []
            example:
              regions:
                - CN
              appId: '989673964'
              activeTimeType: DAY
              start: '2025-11-01'
              end: '2025-11-02'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOListActiveUserVO'
              example:
                requestParam:
                  region: CN
                  appId: '989673964'
                  activeTimeType: DAY
                  start: '2025-11-01'
                  end: '2025-11-02'
                result:
                  appId: '989673964'
                  appName: 王者荣耀
                  icon: >-
                    https://is1-ssl.mzstatic.com/image/thumb/Purple211/v4/86/cb/52/86cb5264-f222-1a8e-b41a-bc87db4ed6cc/AppIcon-1x_U007emarketing-0-8-0-85-220-0.png/88x88w.png
                  activeDetail:
                    - date: '2025-11-01'
                      value: 3945881
                    - date: '2025-11-02'
                      value: 4403594
                creditsCost:
                  requestCredits: 0
                  baseCredits: 10
                  extraCredits: 0
                  totalCostCredits: 10
                next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/1. application Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038422-run
components:
  schemas:
    OpenApiBaseVOListActiveUserVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/ActiveUserParam'
          description: Your request param.
        result:
          type: array
          items:
            $ref: '#/components/schemas/ActiveUserVO'
            description: com.xiaoxi.openapi.model.vo.ActiveUserVO
          description: Your response.
        creditsCost:
          $ref: '#/components/schemas/OpenApiPointCostVO'
          description: Credits cost info.
        next:
          $ref: '#/components/schemas/PaginationInfo'
          description: Next page info
      x-apifox-orders:
        - requestParam
        - result
        - creditsCost
        - next
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    PaginationInfo:
      type: object
      properties:
        taskId:
          type: string
          description: Task ID
        pageKey:
          type: string
          description: Page Key
        totalCount:
          type: integer
          description: Total Count
          format: int64
        totalPages:
          type: integer
          description: Total Pages
          format: int64
      x-apifox-orders:
        - taskId
        - pageKey
        - totalCount
        - totalPages
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    OpenApiPointCostVO:
      type: object
      properties:
        requestCredits:
          type: integer
          description: ''
        baseCredits:
          type: integer
          description: ''
        extraCredits:
          type: integer
          description: ''
        totalCostCredits:
          type: integer
          description: ''
      x-apifox-orders:
        - requestCredits
        - baseCredits
        - extraCredits
        - totalCostCredits
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    ActiveUserVO:
      type: object
      properties:
        region:
          type: string
          description: ''
        details:
          type: array
          items:
            $ref: '#/components/schemas/Detail'
            description: com.xiaoxi.openapi.model.vo.ActiveUserVO.Detail
          description: ''
      x-apifox-orders:
        - region
        - details
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Detail:
      type: object
      properties:
        date:
          type: string
          description: ''
          x-apifox-mock: '@date'
        value:
          type: integer
          description: ''
          format: int64
      x-apifox-orders:
        - date
        - value
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    ActiveUserParam:
      type: object
      properties:
        regions:
          type: array
          items:
            type: string
          description: regions
          examples:
            - - CN
              - US
            - - CN
              - US
        appId:
          type: string
          description: appid
          examples:
            - '835599320'
        activeTimeType:
          type: string
          description: time type(DAY/MONTH)
          enum:
            - DAY
            - MONTH
          x-apifox-enum:
            - value: DAY
              name: DAY
              description: DAY
            - value: MONTH
              name: MONTH
              description: MONTH
          examples:
            - DAY
        start:
          type: string
          description: start date
          x-apifox-mock: '@date'
          examples:
            - '2025-11-10'
        end:
          type: string
          description: end date
          x-apifox-mock: '@date'
          examples:
            - '2025-11-17'
      x-apifox-orders:
        - regions
        - appId
        - activeTimeType
        - start
        - end
      required:
        - appId
        - activeTimeType
        - start
        - end
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    apikey-header-x-openapi-key:
      type: apiKey
      in: header
      name: x-openapi-key
servers:
  - url: https://api.foxdata.com/apiv1/open-api
    description: Api Server
security:
  - apikey-header-x-openapi-key: []

```