# 2005-Market-Active Users & Customers

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /market/active/ranking:
    post:
      summary: 2005-Market-Active Users & Customers
      deprecated: false
      description: >-
        Query user activity by country (DAU/WAU/MAU, active share analysis for
        top apps).
      operationId: 2005_Market_Active Users & Customers
      tags:
        - II. List of Interfaces/2. Market Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  type: string
                  description: Category
                  examples:
                    - APP
                activeType:
                  type: string
                  description: Metric
                  examples:
                    - DAU
                priceType:
                  type: string
                  description: Pricing Info
                  examples:
                    - PAID
                start:
                  type: string
                  description: Start Date
                  examples:
                    - '2025-10-01'
                end:
                  type: string
                  description: End Date
                  examples:
                    - '2025-10-01'
                limit:
                  type: string
                  description: App Count
                  examples:
                    - TOP_10
              x-apifox-orders:
                - category
                - activeType
                - priceType
                - start
                - end
                - limit
              x-apifox-ignore-properties: []
            example:
              store: GP
              region: CN
              category: APP
              activeType: DAU
              priceType: PAID
              start: '2025-10-01'
              end: '2025-10-01'
              limit: TOP_10
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOActiveRankingVO'
              example:
                requestParam:
                  store: GP
                  region: CN
                  category: APP
                  activeType: DAU
                  priceType: PAID
                  start: '2025-10-01'
                  end: '2025-10-01'
                  limit: TOP_10
                result:
                  appInfoMap:
                    ch.swift.itheorieasa:
                      appName: iTheorie Autotheorie 2025
                      icon: >-
                        https://image3.foxdata.com/gp-proxy/cBPMbbzLn855HYhwwAY1vggwjbp545ld0rNlz1mgXrbK6aRZc1a5kyh6vd7efUACCZc
                    com.watchfacestudio.superminimalblack:
                      appName: WIN Super Minimal Black
                      icon: >-
                        https://image2.foxdata.com/gp-proxy/wkj0JST3583_Prd3saN-0TP8Ryu4vWARaD9JRBZ1EiBeY0FRkPGTKWnCH17nHQ83S1of
                  rank:
                    - appId: com.advasoft.touchretouch
                      rank: 1
                      avg: 1321
                      median: 1321
                      max: 1321
                    - appId: com.photopills.android.photopills
                      rank: 2
                      avg: 1050
                      median: 1050
                      max: 1050
                creditsCost:
                  requestCredits: 0
                  baseCredits: 150
                  extraCredits: 0
                  totalCostCredits: 150
                next: null
          headers: {}
          x-apifox-name: ''
      security:
        - apikey-header-x-openapi-key: []
      x-apifox-folder: II. List of Interfaces/2. Market Services
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/4128055/apis/api-478038429-run
components:
  schemas:
    OpenApiBaseVOActiveRankingVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/ActiveRankingQuery'
          description: Your request param.
        result:
          $ref: '#/components/schemas/ActiveRankingVO'
          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: ''
    ActiveRankingVO:
      type: object
      properties:
        appInfoMap:
          $ref: '#/components/schemas/MapAppInfo'
          description: ''
        rank:
          type: array
          items:
            $ref: '#/components/schemas/RankVO'
            description: com.xiaoxi.openapi.model.vo.ActiveRankingVO.RankVO
          description: ''
      x-apifox-orders:
        - appInfoMap
        - rank
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RankVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        rank:
          type: integer
          description: ''
        avg:
          type: integer
          description: ''
          format: int64
        median:
          type: integer
          description: ''
          format: int64
        max:
          type: integer
          description: ''
          format: int64
      x-apifox-orders:
        - appId
        - rank
        - avg
        - median
        - max
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    MapAppInfo:
      type: object
      properties:
        key:
          $ref: '#/components/schemas/key'
      x-apifox-orders:
        - key
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    key:
      type: object
      properties:
        appId:
          type: string
          description: ''
        appName:
          type: string
          description: ''
        icon:
          type: string
          description: ''
      x-apifox-orders:
        - appId
        - appName
        - icon
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    ActiveRankingQuery:
      type: object
      properties:
        store:
          type: string
          description: ''
          enum:
            - AS
            - GP
          x-apifox-enum:
            - value: AS
              name: AS
              description: AS
            - value: GP
              name: GP
              description: GP
        region:
          type: string
          description: ''
        category:
          type: string
          description: ''
          examples:
            - '7014'
        activeType:
          type: string
          description: ''
          enum:
            - DAU
            - WAU
            - MAU
          x-apifox-enum:
            - value: DAU
              name: DAU
              description: DAU
            - value: WAU
              name: WAU
              description: WAU
            - value: MAU
              name: MAU
              description: MAU
          examples:
            - MAU
        priceType:
          type: string
          description: ''
          enum:
            - ALL
            - FREE
            - PAID
          x-apifox-enum:
            - value: ALL
              name: ALL
              description: ALL
            - value: FREE
              name: FREE
              description: FREE
            - value: PAID
              name: PAID
              description: PAID
          examples:
            - ALL
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        limit:
          type: string
          description: ''
          enum:
            - TOP_10
            - TOP_200
            - ALL
          x-apifox-enum:
            - value: TOP_10
              name: TOP_10
              description: TOP_10
            - value: TOP_200
              name: TOP_200
              description: TOP_200
            - value: ALL
              name: ALL
              description: ALL
          examples:
            - TOP_10
      x-apifox-orders:
        - store
        - region
        - category
        - activeType
        - priceType
        - start
        - end
        - limit
      required:
        - store
      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: []

```