# 2004-Market-Download & Revenue Charts

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /ranking/downloadRevenue:
    post:
      summary: 2004-Market-Download & Revenue Charts
      deprecated: false
      description: Query download/revenue estimate chart data in the app market.
      operationId: 2004_Market_Download & Revenue Charts
      tags:
        - II. List of Interfaces/2. Market Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - US
                store:
                  type: string
                  description: App Store
                  examples:
                    - GP
                type:
                  type: string
                  description: Paid Type (default all)
                  examples:
                    - PAID
                category:
                  type: string
                  description: Chart Type ID
                  examples:
                    - '-1'
                metrics:
                  type: string
                  description: >-
                    Metrics; configure per need, separate multiple metrics with
                    commas
                  examples:
                    - - REVENUE
                      - DOWNLOAD
                start:
                  type: string
                  description: Start Date
                  examples:
                    - '2025-09-21'
                end:
                  type: string
                  description: End Date
                  examples:
                    - '2025-09-22'
                limit:
                  type: string
                  description: Default 100, data volume limit
                  examples:
                    - TOP_100
              x-apifox-orders:
                - region
                - store
                - type
                - category
                - metrics
                - start
                - end
                - limit
              x-apifox-ignore-properties: []
            example:
              region: US
              store: GP
              type: PAID
              category: '-1'
              metrics:
                - REVENUE
                - DOWNLOAD
              start: '2025-09-21'
              end: '2025-09-22'
              limit: TOP_100
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOListWankaDownloadRevenueVO'
              example:
                requestParam:
                  region: US
                  store: GP
                  type: PAID
                  category: '-1'
                  metrics:
                    - REVENUE
                    - DOWNLOAD
                  start: '2025-09-21'
                  end: '2025-09-22'
                  limit: TOP_100
                result:
                  - metrics: REVENUE
                    ranks:
                      - appId: com.AlfaOBD.AlfaOBD
                        icon: >-
                          https://image2.foxdata.com/gp-proxy/nBf8jqkXD9cxgD5HRLfD_gpbxztAmlcSJAqZW8xDRdInqhQ0vT2da5i2rSck9pZERA
                        title: AlfaOBD
                        rank: 1
                        change: 0
                        num: 1364
                        trend:
                          - date: '2025-11-28'
                            num: 443
                          - date: '2025-11-29'
                            num: 341
                  - metrics: DOWNLOAD
                    ranks:
                      - appId: com.watchfacestudio.md326
                        icon: >-
                          https://image1.foxdata.com/gp-proxy/wUwkEr66Rd76gd2eYgbdLGwOpdq5POjbRFF_qJI-P3RLtPCObwjhryZcIW4vBomIfw
                        title: MD326 3D Modern Watch Face
                        rank: 1
                        change: 0
                        num: 312
                        trend:
                          - date: '2025-11-28'
                            num: 44
                          - date: '2025-11-29'
                            num: 43
                creditsCost:
                  requestCredits: 0
                  baseCredits: 2000
                  extraCredits: 0
                  totalCostCredits: 2000
                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-478038428-run
components:
  schemas:
    OpenApiBaseVOListWankaDownloadRevenueVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WankaDownloadRevenueQuery'
          description: Your request param.
        result:
          type: array
          items:
            $ref: '#/components/schemas/WankaDownloadRevenueVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WankaDownloadRevenueVO
          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: ''
    WankaDownloadRevenueVO:
      type: object
      properties:
        metrics:
          type: string
          description: ''
        ranks:
          type: array
          items:
            $ref: '#/components/schemas/RankingVO'
            description: com.xiaoxi.openapi.model.vo.wanka.WankaDownloadRevenueVO.RankingVO
          description: ''
      x-apifox-orders:
        - metrics
        - ranks
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    RankingVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        title:
          type: string
          description: ''
        rank:
          type: integer
          description: ''
        change:
          type: integer
          description: ''
        num:
          type: integer
          description: ''
          format: int64
        trend:
          type: array
          items:
            $ref: '#/components/schemas/MetricsTrend'
            description: >-
              com.xiaoxi.openapi.model.vo.wanka.WankaDownloadRevenueVO.MetricsTrend
          description: ''
      x-apifox-orders:
        - appId
        - icon
        - title
        - rank
        - change
        - num
        - trend
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    MetricsTrend:
      type: object
      properties:
        date:
          type: string
          description: ''
          x-apifox-mock: '@date'
        num:
          type: integer
          description: ''
          format: int64
      x-apifox-orders:
        - date
        - num
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WankaDownloadRevenueQuery:
      type: object
      properties:
        region:
          type: string
          description: ''
          examples:
            - US
        store:
          type: string
          description: ''
          enum:
            - AS
            - GP
          x-apifox-enum:
            - value: AS
              name: AS
              description: AS
            - value: GP
              name: GP
              description: GP
          examples:
            - AS
        type:
          type: string
          description: ''
          enum:
            - FREE
            - PAID
          x-apifox-enum:
            - value: FREE
              name: FREE
              description: FREE
            - value: PAID
              name: PAID
              description: PAID
          examples:
            - FREE,PAID（不传默认全部）
        category:
          type: string
          description: ''
          examples:
            - '7014'
        metrics:
          type: array
          items:
            type: string
            enum:
              - DOWNLOAD
              - REVENUE
            x-apifox-enum:
              - value: DOWNLOAD
                name: DOWNLOAD
                description: DOWNLOAD
              - value: REVENUE
                name: REVENUE
                description: REVENUE
          description: ''
          examples:
            - |-
              DOWNLOAD：下载榜单
              REVENUE：收入榜单
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        limit:
          type: string
          description: ''
          enum:
            - TOP_100
            - TOP_200
            - TOP_500
          x-apifox-enum:
            - value: TOP_100
              name: TOP_100
              description: TOP_100
            - value: TOP_200
              name: TOP_200
              description: TOP_200
            - value: TOP_500
              name: TOP_500
              description: TOP_500
          default: '{size: 100, point: 500}'
          examples:
            - TOP_100,TOP_200,TOP_500
      x-apifox-orders:
        - region
        - store
        - type
        - category
        - metrics
        - start
        - end
        - limit
      required:
        - store
        - category
        - metrics
      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: []

```
