# 1005-App-Ranking History

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /app/rank/history:
    post:
      summary: 1005-App-Ranking History
      deprecated: false
      description: Query app chart rankings in the app market (defaults to today).
      operationId: 1005_App_Ranking History
      tags:
        - II. List of Interfaces/1. application Services
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                appId:
                  type: string
                  description: App ID
                  examples:
                    - com.android.chrome
                region:
                  type: string
                  description: Country/Region
                  examples:
                    - US
                device:
                  type: string
                  description: AS apps only
                  examples:
                    - IPHONE
                start:
                  type: string
                  description: Start Date
                  examples:
                    - '2025-09-20'
                end:
                  type: string
                  description: End Date
                  examples:
                    - '2025-09-30'
                limit:
                  type: string
                  description: Last 1 year of data (optional)
                  examples:
                    - ALL
              required:
                - limit
              x-apifox-orders:
                - appId
                - region
                - device
                - start
                - end
                - limit
              x-apifox-ignore-properties: []
            example:
              appId: com.android.chrome
              region: US
              device: IPHONE
              start: '2025-09-20'
              end: '2025-09-30'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OpenApiBaseVOWanKaAppRankHistoryVO'
              examples:
                '1':
                  summary: Success Example
                  value:
                    requestParam:
                      appId: com.android.chrome
                      region: US
                      device: IPHONE
                      start: '2025-09-20'
                      end: '2025-09-30'
                    result:
                      appId: com.android.chrome
                      title: Google Chrome
                      icon: >-
                        https://image1.foxdata.com/gp-proxy/QRRGW2tMZ4-FNw0XWk6WWiXHaQCGxuwM-92HrBhlA4WOd_AGmjVmQkiHyAqQjW2yByc
                      ranks:
                        - categoryId: COMMUNICATION
                          chartsType: FREE
                          data:
                            - date: '2025-09-20'
                              value: 50
                    creditsCost:
                      requestCredits: 0
                      baseCredits: 110
                      extraCredits: 0
                      totalCostCredits: 110
                    next: null
                '2':
                  summary: Success Example
                  value:
                    requestParam:
                      appId: com.android.chrome
                      region: US
                      device: IPHONE
                      start: '2025-09-20'
                      end: '2025-09-30'
                    result:
                      appId: com.android.chrome
                      title: Google Chrome
                      icon: >-
                        https://image1.foxdata.com/gp-proxy/QRRGW2tMZ4-FNw0XWk6WWiXHaQCGxuwM-92HrBhlA4WOd_AGmjVmQkiHyAqQjW2yByc
                      ranks:
                        - categoryId: COMMUNICATION
                          chartsType: FREE
                          data:
                            - date: '2025-09-20'
                              value: 50
                    creditsCost:
                      requestCredits: 0
                      baseCredits: 110
                      extraCredits: 0
                      totalCostCredits: 110
                    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-478038406-run
components:
  schemas:
    OpenApiBaseVOWanKaAppRankHistoryVO:
      type: object
      properties:
        requestParam:
          $ref: '#/components/schemas/WanKaAppRankHistoryQuery'
          description: Your request param.
        result:
          $ref: '#/components/schemas/WanKaAppRankHistoryVO'
          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: ''
    WanKaAppRankHistoryVO:
      type: object
      properties:
        appId:
          type: string
          description: ''
        title:
          type: string
          description: ''
        icon:
          type: string
          description: ''
        ranks:
          type: array
          items:
            $ref: '#/components/schemas/Rank'
            description: com.xiaoxi.openapi.model.vo.wanka.WanKaAppRankHistoryVO.Rank
          description: ''
      x-apifox-orders:
        - appId
        - title
        - icon
        - ranks
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Rank:
      type: object
      properties:
        categoryId:
          type: string
          description: Category Id,-1 means All
        chartsType:
          type: string
          description: Charts type, such as 'FREE', 'PAID', ', 'TOP_GROSSING' etc.
        data:
          type: array
          items:
            $ref: '#/components/schemas/DateHistogramInteger'
          description: Daily Rank
      x-apifox-orders:
        - categoryId
        - chartsType
        - data
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    DateHistogramInteger:
      type: object
      properties:
        date:
          type: string
          description: Date
        value:
          type: integer
          description: Value
      x-apifox-orders:
        - date
        - value
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    WanKaAppRankHistoryQuery:
      type: object
      properties:
        appId:
          type: string
          description: ''
          examples:
            - com.moye.shelter
        region:
          type: string
          description: ''
          examples:
            - US
        device:
          type: string
          description: ''
          enum:
            - IPHONE
            - IPAD
          x-apifox-enum:
            - value: IPHONE
              name: IPHONE
              description: IPHONE
            - value: IPAD
              name: IPAD
              description: IPAD
          default: '{value: 0}'
          examples:
            - IPHONE,IPAD
        start:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        end:
          type: string
          description: ''
          x-apifox-mock: '@date'
          examples:
            - ''
        limit:
          type: string
          description: ''
          enum:
            - ALL
          x-apifox-enum:
            - value: ALL
              name: ALL
              description: ALL
          examples:
            - ALL
      x-apifox-orders:
        - appId
        - region
        - device
        - start
        - end
        - limit
      required:
        - appId
      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: []

```